System and method for describing and identifying abstract software modules in peer-to-peer network environments

ABSTRACT

System and method for describing and identifying abstract software modules in peer-to-peer networking environments. A module class may have one or more module specifications. Each module specification may have one or more module implementations. A module class advertisement may be generated for the module class. A unique module class identifier may be assigned to the module class. A role extension to the module class identifier may be generated for each instance of the module class that performs a different role in a context. A unique module specification identifier may be assigned to each module specification of the module class. In one embodiment, a module specification advertisement may be generated for each module specification. In one embodiment, there may be one or more module implementations for each module specification. In one embodiment, a module implementation advertisement may be generated for each module implementation.

PRIORITY INFORMATION

This application claims benefit of priority to provisional application Ser. No. 60/401,928 filed Aug. 8, 2002 titled Abstracting Software Modules in a Peer-to-Peer Environment, which is hereby incorporated by reference in its entirety.

BACKGROUND OF THE INVENTION

1. Field of the Invention

This invention relates to peer-to-peer networking, and more particularly to abstracting software modules in a peer-to-peer environment.

2. Description of the Related Art

The Internet has three valuable fundamental assets—information, bandwidth, and computing resources—all of which are vastly underutilized, partly due to the traditional client-server computing model. No single search engine or portal can locate and catalog the ever-increasing amount of information on the Web in a timely way. Moreover, a huge amount of information is transient and not subject to capture by techniques such as Web crawling. For example, research has estimated that the world produces two exabytes or about 2×10¹⁸ bytes of information every year, but only publishes about 300 terabytes or about 3×10¹² bytes. In other words, for every megabyte of information produced, only one byte is published. Moreover, Google claims that it searches about only 1.3×10^8 web pages. Thus, finding useful information in real time is increasingly difficult.

Although miles of new fiber have been installed, the new bandwidth gets little use if everyone goes to one site for content and to another site for auctions. Instead, hot spots just get hotter while cold pipes remain cold. This is partly why most people still feel the congestion over the Internet while a single fiber's bandwidth has increased by a factor of 10^6 since 1975, doubling every 16 months.

New processors and storage devices continue to break records in speed and capacity, supporting more powerful end devices throughout the network. However, computation continues to accumulate around data centers, which have to increase their workloads at a crippling pace, thus putting immense pressure on space and power consumption.

Finally, computer users in general are accustomed to computer systems that are deterministic and synchronous in nature, and think of such a structure as the norm. For example, when a browser issues a URL request for a Web page, the output is typically expected to appear shortly afterwards. It is also typically expected that everyone around the world will be able to retrieve the same page from the same Web server using the same URL.

The term peer-to-peer networking or computing (often referred to as P2P) may be applied to a wide range of technologies that greatly increase the utilization of information, bandwidth, and computing resources in the Internet. Frequently, these P2P technologies adopt a network-based computing style that neither excludes nor inherently depends on centralized control points. Apart from improving the performance of information discovery, content delivery, and information processing, such a style also can enhance the overall reliability and fault-tolerance of computing systems.

FIGS. 1A and 1B are examples illustrating the peer-to-peer model. FIG. 1A shows two peer devices 104A and 104B that are currently connected. Either of the two peer devices 104 may serve as a client of or a server to the other device. FIG. 1B shows several peer devices 104 connected over the network 106 in a peer group. In the peer group, any of the peer devices 104 may serve as a client of or a server to any of the other devices.

SUMMARY OF THE INVENTION

A system and method for describing and identifying abstract software modules in peer-to-peer networking environments is described. In a peer-to-peer network, software modules may use the mechanism to provide information about the programming interface and functionality of software modules independently of protocols and behaviors that may be used to implement the software modules. Further, software modules may provide one or more implementations of a given functionality, using various protocols and behaviors, while retaining a common programming interface. The software modules may also provide one or more different network-compatible implementations for different execution environments.

Embodiments may use a tiered architecture to define abstract software modules in peer-to-peer networking environments. A first level of the tier may include one or more module classes. In one embodiment, the module class may include and/or define one or more of, but is not limited to, the “role” a module plays, how the module appears to other modules, and the module's API in each supported binding. In one embodiment, each module class may have one or more module specifications. Each module specification may have one or more module implementations. In one embodiment, a module specification may include, but is not limited to, the module's behavior as it appears from the outside, including the module's wire protocol and the module's compatibility with other instances of the same module, for example on other peers. In one embodiment, each module implementation may be an implementation of a module specification specific to one of one or more execution environments, bindings and/or other constraints.

In embodiments, one or more of these aspects of an abstract software module may be published separately in advertisements. Embodiments may use unique identifiers and advertisements to describe and identify software modules in a hierarchical manner. Using advertisements and identifiers, embodiments may provide a mechanism to identify a particular software module and its behavior. In one embodiment, no matter what platform an entity is on, the entity may preferably discover a particular implementation of the software module for the particular platform and thus be able to use the software module.

In one embodiment, one or more peers in a peer-to-peer network environment may host a class of software module. A module class advertisement may be generated for the module class. The module class advertisement may define a local behavior and an API for each peer-to-peer binding that supports the module class. A module class identifier may be assigned to the class of software module that uniquely identifies the module class. In one embodiment, the module class identifier may be included in the module class advertisement. In one embodiment, a role extension to the module class identifier may be generated for each instance of the module class configured to perform a different role in a context.

In one embodiment, a module specification identifier may be assigned to each of one or more module specifications of the module class. Each module specification identifier uniquely identifies its corresponding module specification. Each module specification may indicate an expected on-wire behavior and one or more network protocols for a particular embodiment of the module class. In one embodiment, a module specification advertisement may be generated for each module specification. In one embodiment, each module specification advertisement includes a corresponding module specification identifier. In one embodiment, each module specification advertisement includes or describes one or more mechanisms to invoke and use the module class.

In one embodiment, one or more module implementations may be generated for each module specification of the module class. Each module implementation is configured to execute within a particular execution environment. In one embodiment, a module implementation advertisement may be generated for each module implementation. In one embodiment, each module implementation advertisement includes a module specification identifier of the corresponding module specification.

BRIEF DESCRIPTION OF THE DRAWINGS

FIG. 1A illustrates a prior art example of two devices that are currently connected as peers;

FIG. 1B illustrates a prior art example of several peer devices connected over the network in a peer group;

FIG. 2 illustrates a tiered architecture for abstracting software modules according to one embodiment;

FIG. 3 illustrates a tiered architecture for abstracting software modules according to another embodiment;

FIG. 4 illustrates a module class advertisement, a module specification advertisement, and a module implementation advertisement for a software module according to one embodiment;

FIG. 5 illustrates an exemplary network with a peer node including a module advertisement and identifier generator according to one embodiment;

FIG. 6 is a flowchart illustrating a method for describing and abstracting a software module according to one embodiment;

FIG. 7 is a flowchart illustrating a method for describing and identifying abstract software modules according to one embodiment;

FIG. 8 is a flowchart illustrating a method for providing multiple embodiments of abstract software modules according to one embodiment;

FIG. 9 is a flowchart illustrating a method for multiplatform implementation of an abstract software module according to one embodiment.

FIG. 10 illustrates one embodiment of peer-to-peer platform software architecture at the conceptual level;

FIG. 11 illustrates an exemplary content identifier according to one embodiment;

FIG. 12 illustrates a point-to-point pipe connection between peers according to one embodiment;

FIG. 13 illustrates a peer-to-peer platform message format according to one embodiment;

FIG. 14 illustrates the content of a peer advertisement according to one embodiment;

FIG. 15 illustrates the content of a peer group advertisement according to one embodiment.

FIG. 16 illustrates the content of a pipe advertisement according to one embodiment;

FIG. 17 illustrates the content of a service advertisement according to one embodiment;

FIG. 18 illustrates the content of a content advertisement according to one embodiment;

FIG. 19 illustrates the content of an endpoint advertisement according to one embodiment;

FIG. 20 illustrates protocols and bindings in a peer-to-peer platform according to one embodiment;

FIG. 21 illustrates discovery through a rendezvous proxy according to one embodiment;

FIG. 22 illustrates discovery through propagate proxies according to one embodiment;

FIG. 23 illustrates using messages to discover advertisements according to one embodiment;

FIG. 24 illustrates one embodiment of using peer resolver protocol messages between a requesting peer and a responding peer;

FIG. 25 illustrates one embodiment of using peer information protocol messages between a requesting peer and a responding peer;

FIG. 26 illustrates several core components and how they interact for discovery and routing according to one embodiment;

FIG. 27 illustrates one embodiment of message routing in a peer-to-peer network that uses the peer-to-peer platform;

FIG. 28 illustrates traversing a firewall in a virtual private network when access is initiated from outside only according to one embodiment;

FIG. 29 illustrates email exchange through an email gateway according to one embodiment;

FIG. 30 illustrates traversing a firewall when access is initiated from the inside according to one embodiment;

FIG. 31 illustrates embodiments of a peer-to-peer platform proxy service, and shows various aspects of the operation of the proxy service;

FIG. 32 illustrates a method of using a proxy service for peer group registration according to one embodiment;

FIG. 33 illustrates peer group registration across a firewall according to one embodiment;

FIG. 34 illustrates a method of providing peer group membership through a proxy service according to one embodiment;

FIGS. 35A and 35B illustrate a method of providing privacy in the peer-to-peer platform according to one embodiment;

FIGS. 36A and 36B illustrate one embodiment of a method for using a peer-to-peer platform proxy service as a certificate authority;

FIG. 37A illustrates a peer in a peer-to-peer network publishing an advertisement according to one embodiment;

FIG. 37B illustrates a peer in a peer-to-peer network publishing an advertisement to a rendezvous peer according to one embodiment;

FIG. 38 illustrates discovering advertisements according to one embodiment;

FIG. 39 illustrates cross-platform activation of a service according to one embodiment;

FIG. 40 is a flowchart illustrating a method of creating a service advertisement according to one embodiment;

FIG. 41 is a flowchart illustrating a method of discovering resource advertisements according to one embodiment;

FIG. 42 illustrates a method of discovering implementations of a service according to one embodiment;

FIG. 43 is a flowchart illustrating a method of cross-platform activation of a service according to one embodiment;

FIG. 44 illustrates a peer providing implementations of a service in two or more different peer groups in which the peer is a member peer according to one embodiment;

FIG. 45 is a flowchart illustrating a method for assigning unique identifiers to peers in a peer-to-peer networking environment according to one embodiment; and

FIG. 46 is a flowchart illustrating a method for assigning unique identifiers to resources in a peer-to-peer networking environment according to one embodiment.

While the invention is described herein by way of example for several embodiments and illustrative drawings, those skilled in the art will recognize that the invention is not limited to the embodiments or drawings described. It should be understood, that the drawings and detailed description thereto are not intended to limit the invention to the particular form disclosed, but on the contrary, the intention is to cover all modifications, equivalents and alternatives falling within the spirit and scope of the present invention as defined by the appended claims. The headings used herein are for organizational purposes only and are not meant to be used to limit the scope of the description or the claims. As used throughout this application, the word “may” is used in a permissive sense (i.e., meaning having the potential to), rather than the mandatory sense (i.e., meaning must). Similarly, the words “include”, “including”, and “includes” mean including, but not limited to.

DETAILED DESCRIPTION OF EMBODIMENTS OF THE INVENTION

A system and method for describing and identifying abstract software modules in peer-to-peer networking environments is described. In a peer-to-peer network, software modules may use the mechanism for abstract identity and definition to provide information about the programming interface and functionality of the software modules independently of protocols and behaviors that may be used to implement the software modules. Further, software modules in a peer-to-peer network may provide one or more implementations of a given functionality, using various protocols and behaviors, while retaining a common programming interface. The software modules may also provide one or more different network-compatible implementations for different execution environments.

While generally described herein for peer-to-peer environments implemented according to an exemplary peer-to-peer platform as described below, it is noted that embodiments of the system and method for describing and identifying abstract software modules in peer-to-peer networking environments may be used in peer-to-peer environments implemented according to other peer-to-peer platforms. Further, it is noted that embodiments may be used in other environments than peer-to-peer environments to describe and identify abstract software modules

Embodiments may use unique identifiers (e.g., UUIDs) and advertisements such as are described for the exemplary peer-to-peer platform described below to describe and identify software modules, such as services and applications, in a hierarchical manner. In one embodiment, a software module may be described in a module class advertisement and given a module class identifier. If that software module is used for different purposes in the same context, the software module may be further identified by an extension to its module class identifier that may be referred to as a role identifier or role extension. Each independent embodiment of the software module that provides an independent set of network protocols and behaviors may be assigned a module specification identifier.

In one embodiment, all implementations of all embodiments of a given module class for a given execution environment have the same programming interface. Therefore, software modules interacting locally may express their dependencies via their respective class identifiers (which may include a role extension), regardless of the particular execution environment and embodiment that was selected when configuring that environment.

In one embodiment, a software module may be assigned a module class identifier. Each independent embodiment of the software module that provides an independent set of network protocols and behaviors may be described by a module specification advertisement and assigned a module specification identifier. In one embodiment, a module specification identifier may be an extension of the identifier of the module class of which the module specification is an embodiment. In one embodiment, each implementation of each module specification may be described by a module implementation advertisement that may include one or more of, but is not limited to, the following information: a module specification identifier, an execution environment description, and a reference to a software environment (e.g. a software package which implements the module specification for the execution environment).

Embodiments may use a tiered architecture to define modules (e.g. services, advertisements, etc.) to abstract software modules in peer-to-peer networking environments. FIG. 2 illustrates a tiered architecture to define modules according to one embodiment. A first level of the tier may include one or more module classes 1000. In one embodiment as illustrated in FIG. 2, each module class 1000 may have one module specification 1002. A module specification 1002 may have one or more module implementations 1004. FIG. 3 illustrates the tiered architecture according to another embodiment. In this embodiment, each module class 1000 may have one or more module specifications 1002. Each module specification 1002 may have one or more module implementations 1004.

In one embodiment, the module class 1000 may include and/or define one or more of, but is not limited to, the “role” a module plays (e.g. in a peer group), how the module appears to other modules (e.g. services and applications), and the module's API in each supported binding. In one embodiment, the module specification(s) 1002 may include and/or define, but is not limited to, the module's behavior as it appears from the outside (e.g. from other modules), including the module's wire protocol and the module's compatibility with other instances of the same module, for example on other peers. In one embodiment, the module implementation(s) 1004 may include one or more implementations of each module specification 1002, with each module implementation 1004 being specific for one or more of various execution environments, bindings and other constraints.

In one embodiment, each of these aspects of an abstract software module may be published separately in advertisements. One embodiment may provide module class advertisements, module specification advertisements, and module implementation advertisements to describe and identify abstract software modules in peer-to-peer networking environments. FIG. 4 illustrates a module class advertisement 1010, a module specification advertisement 1012, and a module implementation advertisement 1014 for a software module according to one embodiment.

In a peer-to-peer environment implemented with the exemplary peer-to-peer platform as described below, network resources such as peers, peer groups, pipes, and modules such as services may be represented by advertisements. Advertisements are language-neutral metadata documents for describing the network resources. Advertisements are used to describe peers, peer groups, pipes, content, modules such as services and other types of network resources. Advertisement types provided by the peer-to-peer platform may include one or more of, but are not limited to, peer advertisements, peer group advertisements, module class advertisements, module specification advertisements, module implementation advertisements, pipe advertisements, and rendezvous advertisements. Advertisements may be exchanged as documents in peer-to-peer protocol messages. One or more of the peer-to-peer platform protocols may use advertisements to provide information to entities interested in the peer-to-peer resources represented by the advertisements. Peer-to-peer platform protocols may be used to pass advertisements between peers and/or to access published advertisements.

In one embodiment, advertisements may include a series of hierarchically arranged elements. An advertisement's elements may appear in arbitrary order within the advertisement. Each element may include data or additional elements. An element may also have attributes. In one embodiment, attributes are name-value string pairs. An attribute may be used, for example, to store meta-data that may describe the data within the element. In one embodiment, peer-to-peer platform advertisements may be represented in the eXtensible Markup Language (XML). Other embodiments may use other encodings such as HTML or WML. In one embodiment, advertisements may be specified using a schema definition language such as the XML Schema Definition Language. In one embodiment, XML advertisements may be translated into other encodings such as HTML and WML to allow peers that do not support XML to access advertised resources. Advertisements are further described in the Advertisements section as well as other sections of the description of the exemplary peer-to-peer platform included below.

In one embodiment, a software module (e.g. service, application, etc.) class may be described by a module class advertisement 1010, identified by a module class identifier 1020 in the module class advertisement 1010. The module specification advertisement(s) 1012 further describes the software module, e.g. the behavior of the software module. The module implementation advertisement(s) 1014 describe implementations of the software module (identified by a module specification identifier 1022 included in the module specification advertisement 1012 and the module implementation advertisement(s) 1014) for different platforms, e.g. Windows, Unix and Solaris platforms. The layers of advertisements (module class advertisement 1010, module specification advertisement(s) 1012, and module implementation advertisement(s) 1014) may be used to abstract software modules (e.g. services, applications, etc.) and platforms, to locate specifications for desired software modules, to locate implementations of the software modules, and to load and run the software modules.

Using advertisements, embodiments may provide a mechanism to identify a particular software module (e.g. a service) and its behavior. In one embodiment, no matter what platform a user (or other entity such as another software module) is on, the user or other entity may locate (e.g. by a discovery process) a particular implementation of the software module for the particular platform and be able to use the software module. In one embodiment, to access a software module, a peer (or other entity such as another software module (e.g. service, application, etc.)) may use a discovery process such as that described herein for the exemplary peer-to-peer platform to discover a module implementation advertisement 1014 corresponding to the execution environment of the peer. In one embodiment, the discovery process may search for and discover module specification advertisements 1012 that meet the specification requirements of the peer, and use the one or more discovered module specification advertisements 1012 to locate a particular module implementation advertisement 1014 for a module implementation suitable for use in the peer's execution environment.

As an example, a user or other entity may be able to locate and use a particular implementation of a printing service for use with the platform the user or other entity is on. In one embodiment, the user or other entity may first search for and locate a specification for the software module. Once the specification is located, the user or other entity may look for a particular implementation of the software module usable on the user or other entity's platform, load the implementation of the software module according to the advertisements for use on the platform, and run the software module.

The layers of advertisements may also serve to separate the specification from the implementation. This may reduce the size of the module implementation advertisements 1014, as the advertisements do not need to include the full specification for the software module but instead may refer back to the specification advertisement via the module specification identifier. This may allow software modules to be initially located by specification for a particular class of functionality, rather than having to search through many implementation advertisements of software modules to find a desired implementation of a specification, preferably making the discovery process simpler.

In one embodiment, on a Java platform, after locating a desired module implementation advertisement 1014, using a PURI (Package Uniform Resource Identifier) included in the module implementation advertisement 1014, a URI or URL to the actual code and/or other data of the software module may be specified. In one embodiment, on other platforms such as Unix and Linux, one or more locations for software module code and/or other data may be specified by URL, URI, or other mechanisms. The code may be downloaded, referenced on disk, or referenced by the URI or other mechanism. The SURI (Specification URI, described below) of the module specification advertisement may function similarly to retrieve a document containing the module specification. In one embodiment, on some platforms, software module code and/or other data may be included in the module implementation advertisement 1014.

In one embodiment, a peer node may include a module advertisement and identifier generator for describing and identifying abstract software modules in peer-to-peer networking environments by generating module identifiers (e.g. module class identifiers 1020 and module specification identifiers 1022) and module advertisements (e.g. module class advertisements 1010, module specification advertisements 1012, and module implementation advertisements 1014) for classes of software modules. If a software module is used for different purposes in the same context, the software module may be further identified by an extension to its module class identifier that may be referred to as a role identifier or role extension, which may also be generated by the module advertisement and identifier generator.

FIG. 5 illustrates an exemplary network with a peer node including a module advertisement and identifier generator according to one embodiment. Peer node 1032A may be any of various types of devices, including, but not limited to, a personal computer system, desktop computer, laptop or notebook computer, mainframe computer system, workstation, network appliance, network computer, Internet appliance, or other suitable device. Peer node 1032A may include at least one processor 1034. The processor 1034 may be coupled to a memory 1036. Memory 1036 is representative of various types of possible memory media, also referred to as “computer readable media.” Hard disk storage, floppy disk storage, removable disk storage, flash memory and random access memory (RAM) are examples of memory media. The terms “memory” and “memory medium” may include an installation medium, e.g., a CD-ROM or floppy disk, a computer system memory such as DRAM, SRAM, EDO RAM, SDRAM, DDR SDRAM, Rambus RAM, etc., or a non-volatile memory such as a magnetic media, e.g., a hard drive or optical storage. The memory medium may include other types of memory as well, or combinations thereof. Peer node 1032A may couple over network 1030 to one or more other network devices such as other peer nodes 1032B and 1032C via one or more wired or wireless network interfaces (not shown).

Peer node 1032A may include, in memory 1036, a module advertisement and identifier generator 1038 that may serve as a means for generating module advertisements and module identifiers (including role extensions) for classes of modules in memory 1036 on host machine 1032A. Module class identifier 1020 may serve as a means for uniquely identifying a class of software module 1000 on peer node 1032A as well as on network 1030. Module specification identifier 1022 may serve as a means for uniquely identifying a module specification 1002 on peer node 1032A as well as on network 1030. A role extension (not shown) to the module class identifier 1020 may serve as a means for uniquely identifying a software module used for different purposes in the same context. Module class advertisement 1010, module specification advertisement 1012, and module implementation advertisement 1014 may serve as means for describing and advertising module class 1000, module specification 1002, and/or module implementation 1004, respectively, to other entities (e.g. peers, services, applications, etc.) on network 1030. Note that while FIG. 5 illustrates one module specification 1002 for module class 1000, and one module implementation 1004 for module specification 1002, in one embodiment, there may be two or more module specifications 1002 for module class 1000. In addition, there may be two or more module implementations 1004 for each module specification 1002.

Each peer node 1032 may host one or more peers (not shown). A peer may be defined as any entity or collection of resources that runs some or all of one or more protocols used in a particular peer-to-peer network environment, for example one or more of the peer-to-peer protocols in a particular peer-to-peer network environment implemented according to the exemplary peer-to-peer platform described below. As such, a peer may manifest in the form of a processor, a process, a device, or even a collection of devices. A peer may be implemented on any device with a digital heartbeat that supports the peer-to-peer environment, including sensors, servers, PCs, computers up to and including supercomputers, PDAs, manufacturing and medical equipment, phones and cellular phones. As mentioned above, a peer node 1032 may include one or more peers. In one embodiment, two or more devices may be configured to perform as a single peer in a peer-to-peer network. In this case, the two or more devices may be considered a single peer node.

In order to interact with other peers (e.g. to form or join peer groups), a peer needs to be connected (e.g. by one or more network interfaces of its hosting peer node 1032) to some kind of network 1000 (wired or wireless), such as IP, Bluetooth, or Havi, among others. A peer is typically associated with one network location represented by a unique identifier.

In one embodiment, each peer node 1032 on the network 1030 may include one or more instances of module advertisement and identifier generator 1038 for generating module advertisements and module identifiers for module classes 1000 on the peer node 1032. In one embodiment, there may be one instance of module advertisement and identifier generator 1038 for each peer on a peer node 1032. In another embodiment, a module advertisement and identifier generator (e.g. a service) may be provided by one or more peer nodes 1032 on the network 1030 for use by other peer nodes 1032 on the network 1030 in generating module advertisements and module identifiers for module classes 1000 on the peer nodes 1032. In one embodiment, module advertisement and identifier generator 1038 may be provided by a peer-to-peer platform such as the exemplary peer-to-peer platform described below.

In one embodiment, generated module advertisements. (e.g. module class advertisement 1010, module specification advertisement 1012, and module implementation advertisement 1014) may be stored locally on peer node 1032A and published on the network 1030 for discovery by other peer nodes 1032. In one embodiment, generated module advertisements may be provided to one or more other nodes on network 1030, including one or more other peer nodes 1032, to be published for discovery on the network 1030.

In one embodiment, a module class advertisement 1010 may be used to describe a class of software modules. A module class advertisement 1010 may describe an expected local behavior and an expected API for each peer-to-peer platform binding that supports the class of software modules. A module class advertisement 1010 may provide a description of what a particular module class identifier 1020 stands for. Module class identifiers 1020 may be used by a software module or other code in the peer-to-peer network environment to designate software modules upon which the software module or other code depends. In one embodiment, a module class advertisement 1010 may not fully describe the corresponding module's behavior and API; instead, the module's behavior and API may be further described in module specification advertisement(s) 1012 and module implementation advertisement(s) 1014. In one embodiment, a module class advertisement 1010 may be used to create modules with similar functionality.

The following illustrates an exemplary module class advertisement 1010 schema that may be used in embodiments and is not intended to be limiting:

<xs:element name=“MCA” type=“xxxx:MCA”/> <xs:complexType name=“MCA”>  <xs:sequence>   <xs:element name=“MCID” type=“xxxx:identifier”/>   <xs:element name=“Name” type=“xs:string” minOccurs=“0”/>   <xs:element name=“Desc” type=“xs:anyType” minOccurs=“0”/>  </xs:sequence> </xs:complexType> where the elements may include one or more of, but are not limited to:

-   -   MCID—Module class identifier 1020 that uniquely identifies the         module class. Each module class may have a unique identifier. In         one embodiment, this is a required element.     -   Name—A name associated with the module class. In one embodiment,         the name is not required to be unique unless the name is         obtained from a centralized naming service that guarantee name         uniqueness. In one embodiment, this is an optional element.     -   Desc—Description. A string that may be used to describe and         search for a module class. In one embodiment, this is an         optional element.

In one embodiment, a module specification advertisement 1012 may be used to describe the specification of a software module. A module specification advertisement 1012 may describe, for example, an expected on-wire behavior and protocol for the module. A module specification advertisement 1012 may provide a description of what a particular module specification identifier 1022 represents. A module specification identifier 1022 may be used by a software module or other entity in the peer-to-peer environment to designate a particular network-compatible family of implementations of a given module class described by a corresponding module class advertisement 1010 and identified by a module class identifier 1020.

In some embodiments of a peer-to-peer platform, one or more core peer group services (e.g. discovery, membership, resolver, etc.) may be implemented as software modules. In one embodiment, module specification identifiers 1022 may be used by a peer group implementation to designate the components that provide the various services that the peer group supports.

A module specification advertisement 1012 may also describe how to invoke and use a software module. In one embodiment, a software module may be accessed through an API (application programming interface) of the module by locating an implementation of the software module, loading the module, and starting the module. In one embodiment, a software module may be accessed via a peer-to-peer communications channel (e.g. a peer-to-peer platform pipe as described below). In one embodiment, an advertisement for the communications channel (e.g. a pipe advertisement as described below) may be included in the software module's module specification advertisement 1012. In one embodiment, a software module may be accessed through a proxy module accessed using a module specification identifier 1022 of the proxy module included in the software module's module specification advertisement 1012.

The following illustrates an exemplary module specification advertisement 1012 schema that may be used in embodiments and is not intended to be limiting:

<xs:element name=“MSA” type=“xxxx:MSA”/> <xs:complexType name=“MSA”>  <xs:sequence>   <xs:element name=“MSID” type=“xxxx:IDENTIFIER”/>   <xs:element name=“Vers” type=“xs:string”/>   <xs:element name=“Name” type=“xs:string” minOccurs“0”/>   <xs:element name=“Desc” type=“xs:anyType” minOccurs=“0”/>   <xs:element name=“Crtr” type=“xs:string” minOccurs=“0”/>   <xs:element name=“SURI” type=“xs:anyURI” minOccurs=“0”/>   <xs:element name=“Parm” type=“xs:anyType” minOccurs=“0”/>   <xs:element ref=“xxxx:PipeAdvertisement” minOccurs=“0”/>   <xs:element name=“Proxy” type=“xs:anyURI” minOccurs=“0”/>   <xs:element name=“Auth” type=“xxxx:IDENTIFIER” minOccurs=   “0”/>  </xs:sequence> </xs:complexType> where the elements may include one or more of, but are not limited to:

-   -   MSID—module specification identifier 1022. May uniquely identify         this module specification. Each module specification may have a         unique module specification identifier 1022. In one embodiment,         this is a required element.     -   Vers—The version of the module specification that this         advertisement advertises. In one embodiment, this is a required         element.     -   Name—Name that may be associated with a module specification.         The name may not be required to be unique. In one embodiment,         the name may be obtained from a centralized naming service that         guarantee name uniqueness, and therefore in this embodiment the         name may be unique. In one embodiment, this is an optional         element.     -   Desc—Description. A string that may be used to describe and         search for a module specification. In one embodiment, this is an         optional element.     -   CRTR—Creator. This element designates the creator of this module         specification. In one embodiment, this is an optional element.     -   SURI—Specification URI (Uniform Resource Identifier). This         element is a resource identifier that permits the retrieval of a         document containing the module specification that this         advertisement advertises. In one embodiment, this is an optional         element.     -   Parm—May include one or more arbitrary parameters that may be         interpreted by each implementation.     -   xxxx:PipeAdvertisement—Identifies a pipe advertisement which         this module binds to an input pipe, and which thus may be used         to establish a pipe to an implementation of this module         specification. In one embodiment, this element name may be         identical to the pipe advertisement document type since the         entire element is an embedded pipe advertisement document. In         one embodiment, this is an optional element.     -   Proxy—Proxy specification identifier. This is a module         specification identifier 1022 of a proxy module that may be used         in order to communicate with modules of this specification. Note         that the process may be recursive. The proxy module may be         usable via pipes, or optionally through a subsequent proxy         module, and may require a subsequent authenticator. In one         embodiment, this is an optional element.     -   Auth—Authenticator specification identifier. This is a module         specification identifier 1022 of an authenticator module that         may be used to authenticate entities that desire to communicate         with modules of this specification. Note that the process may be         recursive. The authenticator module may be usable via pipes, or         optionally through a subsequent proxy module, and may require a         subsequent authenticator. In one embodiment, this is an optional         element.

In one embodiment, a module implementation advertisement 1024 may be used to describe a particular implementation of a module specification. Implementations of a given specification may be searched for using the module specification identifier 1022. An implementation may be selected, for example, by the type of environment in which the implementation may be used (specified in the implementation advertisement's compatibility element) as well as by its name, description, and/or the content of its parameters element.

A module implementation advertisement 1024 may provide a mechanism to retrieve data that may be required or desired in order to execute the module implementation being described. In one embodiment, this information may be encapsulated in the <Code> and <PURI> (Package Uniform Resource Identifier) elements. The interpretation of these elements may be subject to the module's compatibility. For example, a standard peer group implementation of a Java reference implementation may expect the <Code> element to specify a fully qualified Java class name that designates a subclass such as net.xxxx.platform.Module and PURI to be the URI (Uniform Resource Identifier) of a downloadable package (e.g. a .jar file). Other execution environments may expect the code to be inline within the <Code> element or may offer two or more options.

The following illustrates an exemplary module implementation advertisement 1024 schema that may be used in embodiments and is not intended to be limiting:

<xs:element name=“MIA” type=“xxxx:MIA”/> <xs:complexType name=“MIA”>  <xs:sequence>  10 <xs:element name=“MSID” type=“xxxx:IDENTIFIER”/>  10 <xs:element name=“Comp” type=“xs:anyType”/>  10 <xs:element name=“Code” type=“xs:anyType”/>  10 <xs:element name=“PURI” type=“xs:anyURI” minOccurs=“0”/>  10 <xs:element name=“Prov” type=“xs:string” minOccurs=“0”/>  10 <xs:element name=“Desc” type=“xs:anyType” minOccurs=  10 “0”/>  10 <xs:element name=“Parm” type=“xs:anyType” minOccurs=  10 “0”/>  </xs:sequence> </xs:complexType> where the elements may include one or more of, but are not limited to:

-   -   MSID—module specification identifier 1022. May uniquely identify         the module specification being implemented. In one embodiment,         this is a required element.     -   Comp—Compatibility. An arbitrary element that may describe the         environment in which this module implementation may be executed.         Each framework capable of loading and executing the module may         have its own requirements on the contents of this element. In         one embodiment, this is a required element.     -   Code—This arbitrary element may include anything that is needed         in addition to the package in order to load and execute the code         of this module implementation. In one embodiment, for Java         module implementations, this element may include a fully         qualified class name containing the module's entry points. In         one embodiment, this element may include the entire code.     -   PURI—Package URI (Uniform Resource Identifier). This element is         a resource identifier that permits the retrieval of a package         containing the code of this module implementation. In one         embodiment, this is an optional element.     -   Prov—Provider. The provider of this module implementation. In         one embodiment, this is an optional element.     -   Desc—Description. A string that may be used to describe and         search for a module specification. In one embodiment, this is an         optional element.     -   Parm—Parameter. May include one or more arbitrary parameters         that may be interpreted by the module implementation's code.

FIG. 6 is a flowchart illustrating a method for describing and abstracting a software module according to one embodiment. As indicated at 1100, for a class of software module, a module class advertisement, for example the module class advertisement described above, may be generated. A module class identifier may be generated and included in the module class advertisement. As indicated at 1102, one or more module specification advertisements may be generated. A module specification identifier may be generated for each software module specification and included in the corresponding module specification advertisement. As indicated at 1104, one or more module implementation advertisements may be generated for each module specification advertisement. The module specification identifier for the corresponding module specification may be included in each module implementation advertisement. These advertisements may be published in the peer-to-peer network, for example a peer-to-peer network implemented according to the exemplary peer-to-peer platform described herein to provide discovery of and access to the corresponding software module to peers in the peer-to-peer network.

FIG. 7 is a flowchart illustrating a method for describing and identifying abstract software modules according to one embodiment. One or more of a plurality of peers in a peer-to-peer network environment may host a class of software module. As indicated at 1110, a module class advertisement may be generated for the class of software module. The module class advertisement may define a local behavior and an Application Programming Interface (API) for each of one or more peer-to-peer bindings that supports the class of software module. As indicated at 1112, a module class identifier may be assigned to the class of software module that uniquely identifies the class of software module. In one embodiment, the module class identifier may be included in the module class advertisement. In one embodiment, a role extension to the module class identifier may be generated for each instance of the class of software module configured to perform different roles in a context. In one embodiment, the role extension may be included in the module class advertisement.

As indicated at 1114, a different module specification identifier may be assigned to each of one or more module specifications of the class of software module. Each module specification identifier uniquely identifies its corresponding module specification. In one embodiment, each module specification indicates an expected on-wire behavior and one or more network protocols for a particular embodiment of the class of software module. In one embodiment, a module specification advertisement may be generated for each module specification. In one embodiment, each module specification advertisement includes a corresponding module specification identifier. In one embodiment, each module specification advertisement includes or describes one or more mechanisms to invoke and use the class of software module.

In one embodiment, one or more module implementations may be generated for each module specification of the class of software module. Each module implementation is configured to execute within a particular execution environment. In one embodiment, a module implementation advertisement may be generated for each module implementation. In one embodiment, each module implementation advertisement includes a module specification identifier of the module specification implemented by the module implementation described and advertised by the module implementation advertisement. In one embodiment, two or more module implementations of the class of software module configured to execute within a particular execution environment may provide a common programming interface. As a result, software modules interacting locally may express their dependencies via their module class identifiers (including role extensions, if any), regardless of the particular execution environment and embodiment that was selected when configuring the execution environment.

FIG. 8 is a flowchart illustrating a method for providing multiple embodiments of abstract software modules according to one embodiment. One or more of a plurality of peers in a peer-to-peer network environment may host a class of software module. As indicated at 1120, a module class identifier may be assigned to the class of software module. In one embodiment, a module class identifier uniquely identifies a corresponding class of software module. As indicated at 1122, one or more module specification advertisements may be generated for the class of software module. In one embodiment, each module specification advertisement describes a module specification including an expected on-wire behavior and protocol of the class of software module. In one embodiment, each module specification advertisement further describes one or more mechanisms to invoke and use the class of software module. In one embodiment, a module specification identifier may be generated for each module specification that uniquely identifies the module specification. In one embodiment, the module specification identifiers may be included in the corresponding module specification advertisements.

As indicated at 1124, one or more module implementation advertisements may be generated for each module specification advertisement. In one embodiment, each module implementation advertisement describes a particular module implementation of a corresponding module specification configured to execute within a particular execution environment. In one embodiment, a module specification identifier of the corresponding module specification may be included in each module implementation advertisement. In one embodiment, each module implementation advertisement may include an indication of a mechanism for accessing code of the particular module implementation. In one embodiment, each module implementation advertisement may include a description of the particular execution environment in which the corresponding module implementation is configured to execute. In one embodiment, each module implementation advertisement is discoverable by peers on the peer-to-peer network for use by the peers to implement corresponding module specifications in particular execution environments of the peers.

FIG. 9 is a flowchart illustrating a method for multiplatform implementation of an abstract software module according to one embodiment. One or more of a plurality of peers in a peer-to-peer network environment may host a class of software module. As indicated at 1130, a module class identifier may be assigned to the class of software module. In one embodiment, a module class identifier uniquely identifies a corresponding class of software module. As indicated at 1132, a module specification identifier may be assigned to each of one or more module specifications of the class of software module. In one embodiment, each module specification identifier uniquely identifies a corresponding module specification. In one embodiment, each module specification indicates an expected on-wire behavior and one or more network protocols for a particular embodiment of the class of software module.

As indicated at 1134, one or more module implementation advertisements may be generated for each module specification advertisement. In one embodiment, each module implementation advertisement describes a particular module implementation of a corresponding module specification configured to execute within a particular execution environment. In one embodiment, each module implementation advertisement may include a module specification identifier that uniquely identifies the module specification implemented by the module implementation corresponding to the module implementation advertisement. In one embodiment, each module implementation advertisement may include an indication of a mechanism for accessing code of the particular module implementation. In one embodiment, each module implementation advertisement may include a description of the particular execution environment in which the corresponding module implementation is configured to execute. In one embodiment, each module implementation advertisement is discoverable by peers on the peer-to-peer network for use by the peers to implement corresponding module specifications in particular execution environments of the peers. In one embodiment, two or more module implementations of the class of software module configured to execute within a particular execution environment may provide a common programming interface. As a result, software modules interacting locally may express their dependencies via their module class identifiers (including role extensions, if any), regardless of the particular execution environment and embodiment that was selected when configuring the execution environment.

The following are descriptions of embodiments of peer advertisements and peer group advertisements that may be used in embodiments of the system and method for describing and identifying abstract software modules in peer-to-peer networking environments.

A peer advertisement may describe a peer and the resources it provides to the group. A peer advertisement may include specific information about the peer including one or more of, but not limited to, its name, its unique identifier, its group identifier and descriptive information. A peer advertisement may also include endpoint addresses and any run-time attributes that individual peer services want to publish (such as being a rendezvous peer for a group).

The following illustrates an exemplary peer advertisement schema that may be used in embodiments and is not intended to be limiting:

<xs:element name=“PA” type=“xxxx:PA”/> <xs:complexType name=“PA”>  <xs:sequence>    <xs:element name=“PID” type=“IDENTIFIER”/>    <xs:element name=“GID” type=“IDENTIFIER”/>    <xs:element name=“Name” type=“xs:string” minOccurs=“0”/>    <xs:element name=“Desc” type=“xs:anyType” minOccurs=    “0”/>    <xs:element name=“Svc” type=    “xxxx:serviceParams” minOccurs=“0”      maxOccurs=“unbounded”/>  <xs:sequence> </xs:complexType> where the elements may include one or more of, but are not limited to:

-   -   PID—Peer identifier that may uniquely identify the peer. Each         peer may have a unique identifier. In one embodiment, this is a         required element.     -   GID—The peer group identifier. This element may identify         canonically which peer group this peer belongs to.     -   Name—A string that may be associated with the peer. In one         embodiment, the name may not be required to be unique. In one         embodiment, the name may be obtained from a centralized naming         service that guarantees name uniqueness. In one embodiment, this         is an optional element.     -   Desc—A string that may be used to index and search for a peer.         In one embodiment, the string is not guaranteed to be unique.         Two peers may have the same keywords. In one embodiment, this is         an optional element.     -   Svc—Service. In one embodiment, any number of service elements         may be included. In one embodiment, ach of the service elements         may describe the association between a group service which may         be denoted by its module class identifier (the value of an MCID         (module class identifier) element), and arbitrary parameters         encapsulated in a Parm (parameter) element. For example, all         accessible endpoint addresses may be published in association         with the Endpoint Service Module Class Identifier. The TLS Root         certificate may be published under the Peer group Module Class         Identifier (There may be a module class identifier for a Peer         Group as well). The flag that denotes that this peer is a         rendezvous for this group may be published under the Rendezvous         Service module class identifier. In one embodiment, each service         may be responsible for what is published under its module class         identifier. The Service section may also optionally include an         element (e.g., “isOff”) that may be used to indicate if this         service is enabled or disabled. This element may be used to         convey a configuration choice made by the owner of the peer.

A peer group advertisement may be used to describe peer group-specific resources including one or more of, but not limited to, name, group identifier, description, specification, and service parameters. The following illustrates an exemplary peer group advertisement schema that may be used in embodiments and is not intended to be limiting:

<xs:element name=“PGA” type=“xxxx:PGA”/> <xs:complexType name=“PGA”>  <xs:sequence>    <xs:element name=“GID” type=“xxxx:IDENTIFIER”/>    <xs:element name=“MSID” type=“xxxx:IDENTIFIER”/>    <xs:element name=“Name” type=“xs:string” minOccurs=    “0”/>    <xs:element name=“Desc” type=“xs:anyType” minOccurs=    “0”/>    <xs:element name=“Svc” type=“xxxx:serviceParam” minOccurs=    “0”      maxOccurs=“unbounded”/>  </xs:sequence> </xs:complexType> where the elements may include one or more of, but are not limited to:

-   -   GID—This element provides the peer group identifier. The peer         group identifier is the canonical way of referring to a group         and uniquely identifies the peer group.     -   MSID—Peer group specification identifier. This designates the         module that provides the peer group mechanism for the group. The         specification identifier may include an abstraction of that         mechanism. This abstraction may be optionally described by a         module specification advertisement, and one or more         implementations may exist, which may each be described by a         module implementation advertisement. In one embodiment, these         advertisements may all be searched by peer group specification         identifier. In one embodiment, this is a required element.     -   Name—A name that may be associated with the peer group. In one         embodiment, the name is not required to be unique. In one         embodiment, the name may be obtained from a centralized naming         service that guarantee name uniqueness. In one embodiment, this         is an optional element.     -   Desc—This element provides descriptive information that may be         used to index and search for a peer group. In one embodiment,         the content of this element may not be unique. For example, two         peer groups may have the same keywords.     -   Svc—Service. In one embodiment, any number of service elements         may be included. Each service element may describe the         association between a group service denoted by its module class         identifier (the value of an MCID element), and one or more         arbitrary parameters encapsulated in a Parm element. This         optional parameter may only be meaningful to some services. It         may be used to configure a service specifically in relation with         its use by this group. For example, a simple membership service         may find an encrypted password list there. In one embodiment,         this is an optional element.

The following describes in greater detail various types of peer-to-peer platform identifiers that may be used in embodiments of the system and method for describing and identifying abstract software modules in peer-to-peer networking environments.

In embodiments of peer-to-peer platforms such as the exemplary peer-to-peer platform described herein, peer-to-peer platform protocols may need to refer to peers, peer groups, pipes and other peer-to-peer platform resources. In one embodiment, these references may be presented in the protocols as peer-to-peer platform identifiers. Peer-to-peer platform identifiers may provide a mechanism for uniquely identifying specific peer groups, peers, pipes, contents and service instances, among other resources. Peer-to-peer platform identifiers may provide unambiguous references to the various peer-to-peer platform entities. There may be several types of peer-to-peer platform entities which may have peer-to-peer platform identifier types defined including one or more of, but not limited to: peer groups, peers, pipes, content, module classes and module specifications.

In one embodiment, peer-to-peer platform identifiers may be presented as Uniform Resource Names (URNs). URNs are a form of URI (Uniform Resource Identifier) that are intended to serve as persistent, location-independent, resource identifiers. Like other forms of URI, peer-to-peer platform identifiers are presented as text. See IETF RFC 2141 for more information on URNs.

In one embodiment, a peer-to-peer platform identifier is a standard URN in the peer-to-peer platform identifier namespace. Peer-to-peer platform identifier URNs are identified by a namespace identifier, for example “xxxx”. Each peer-to-peer platform identifier URN may also include an identifier format keyword. The identifier format keyword may indicate how the identifier was created and may allow peer-to-peer platform bindings to extract additional information from the identifier. In one embodiment, peer-to-peer platform identifier formats may be defined to refer to resources both within peer-to-peer platform and to bridge to other technologies. One embodiment may use the ABNF syntax as defined in “IETF RFC 2234” as a format specification.

When peer-to-peer platform identifiers are used within peer-to-peer platform protocols, the identifiers may be manipulated as text string URIs. Operations available for URIs include compare, resolve, and decompose. Peer-to-peer platform identifier URIs may be compared for equality as strings. Peer-to-peer platform identifier URIs may also be resolved to the resource they reference. Peer-to-peer platform identifier URIs may be decomposed and interpreted by peer-to-peer platform bindings. To interpret a peer-to-peer platform identifier, a peer-to-peer platform binding may support the identifier format used by that peer-to-peer platform identifier. For many peer-to-peer platform protocols and operations, it may not be necessary to decompose the peer-to-peer platform identifiers.

Peer group identifiers refer to peer groups. In one embodiment, a peer group identifier may canonically, uniquely and unambiguously refer to a peer group. In one embodiment, other identifier formats may support this identifier type because the other identifier types may refer to the peer group to which they belong.

Peer identifiers refer to peers. In one embodiment, a peer identifier may canonically, uniquely and unambiguously refer to a peer. If a peer-to-peer platform binding recognizes the identifier format, it may be able to extract a peer group identifier from a peer identifier. This peer group identifier identifies the peer group of which the peer is a member.

In one embodiment, a module class identifier may identify a particular local behavior; for example, a specific API for each execution environment for which an implementation of the module exists. A module class identifier may canonically, uniquely and unambiguously refer to a module class as defined by an advertisement. If a peer-to-peer platform binding recognizes the module class identifier type, it should be able to extract a base class identifier from a module class identifier. The base class identifier allows applications to determine if two module class identifiers differ only in the “role” they perform. Module specification identifiers' “roles” may allow the same module to be reused within a group and to have instances distinguished. This may be necessary when, for example, a common database service is used, with each “role” accessing a different data set.

In one embodiment, a module specification identifier may uniquely identify a particular network behavior (e.g. wire protocol and choreography) that may be embodied by a software module. In one embodiment, there may be any number of implementations of a given module specification identifier. A module specification identifier may uniquely identify an abstract module for which there may be multiple platform-specific implementations. A module specification identifier may be used to locate a compatible implementation so that it can be instantiated. In one embodiment, all such implementations are assumed network-compatible. A module specification identifier may canonically, uniquely and unambiguously refer to a module specification. If a peer-to-peer platform binding recognizes this identifier type, it should be able to extract a Module class identifier from a Module specification identifier. In one embodiment, each peer-to-peer platform identifier types may have a specific definition for how its fields are represented within its structure.

In one embodiment, for peer-to-peer platform module class identifiers, each module may be assigned a module service identifier that may enable canonical references to be made to the service in the context of a specific peer group, and optionally within the context of a specific peer. In one embodiment, for peer-to-peer platform module specification identifiers, each service may be assigned a unique service identifier that may enable canonical references to be made to the service in the context of a specific peer group, and optionally within the context of a specific peer.

The following describes network services in a peer-to-peer environment implemented in accordance with a peer-to-peer platform such as the exemplary peer-to-peer platform described herein. Embodiments of the system and method for describing and identifying abstract software modules in peer-to-peer networking environments as described herein may be used in implementing the network services. A network service may be considered as one type of software module that may be abstracted using embodiments. Software modules may also include applications, among other types.

In one embodiment, peers may cooperate and communicate to publish, discover and invoke network services. In one embodiment, peers may discover network services via the peer discovery protocol of the exemplary peer-to-peer platform described herein. In one embodiment, network services may include peer services and peer group services. A peer service may be accessible only on the peer that is publishing the service. If that peer happens to fail, then the service also fails. Multiple instances of the service may be run on different peers, but each instance publishes its own advertisement. A peer group service is composed of a collection of instances (potentially cooperating with each other) of the service running on multiple members of the peer group. If any one peer fails, the collective peer group service may not be affected, because the service may still be available from another peer member. Peer group services may be published as part of the peer group advertisement.

In one embodiment, services may be pre-installed into a peer or loaded from the network. The peer may follow a process of finding, downloading and installing a service from the network. To run a service, a peer may have to locate an implementation of the service (i.e. a module implementation) suitable for the peer's runtime environment. Multiple implementations of the same service may allow, for example, Java peers to use Java code implementations, and native peers to use native code implementations.

In one embodiment, the peer-to-peer platform may be designed to interoperate and be compatible with various Web service standards including one or more of, but not limited to, WSDL, uPnP, RMI, etc. The peer-to-peer platform protocols may define a generic framework to publish and discover advertisements that may describe services. In one embodiment, peers may publish and discover advertisements via the peer discovery protocol. In one embodiment, an advertisement for a service may include necessary information to either invoke or instantiate the service being described. In one embodiment, one or more peer-to-peer platform protocols may define module advertisements to describe services.

In one embodiment, peer-to-peer platform-enabled services are services that are published using module specification advertisements. In one embodiment, a module specification advertisement may specify a pipe advertisement that may be used by a peer to create output pipes to invoke the service. In one embodiment, a module specification advertisement may include a list of pre-determined messages that may be sent by a peer to interact with the service. In one embodiment, a module specification advertisement may include references to one or more other services that may be used as an authenticator for the service and/or as a local proxy for the service. In one embodiment, each service may be uniquely identified by its module specification identifier.

In one embodiment, a service may have several aspects including, but not limited to:

-   -   The “role” the service plays in the group; how the service         appears to other services and applications, plus the service's         API in each supported binding. This may be referred to as the         service class (i.e. the module class).     -   The service's apparent behavior from the outside, including, but         not limited to, wire protocol, and compatibility with the same         service on other peers. In other words, a central definition of         a service, or the service's specification. This may be referred         to as the service specification (i.e. the module specification).     -   One or more implementations of the specification for various         execution environments, bindings and other constraints. These         may be referred to as the service implementations (i.e. module         implementations).

Each of these aspects of a service may be published separately, e.g. by the module advertisements described above. In one embodiment, there may be more specifications than classes and more implementations than specifications. In many cases, only the implementation is needed, for example, when instantiating a group that uses the service(s). The layered arrangement of class/specification(s)/implementation(s) may help save storage space by not requiring that information be duplicated in all implementation advertisements, and also may help to prevent the downloading of unneeded data. If this information was duplicated in all implementation advertisements, not only would it occupy more storage space than needed, but it also may cause the downloading of unneeded data.

Service specifications may be assigned a unique identifier at the time the advertisement is published. Service implementations may use this identifier to denote which service specification they implement. Service classes may be assigned a unique identifier when the class's advertisement is first published.

In one embodiment, service specifications may use identical implementations; therefore, service specification advertisements may include a “free form” parameter section that includes one or more parameters that may be used to control behavior. In one embodiment, service implementations may use identical code; therefore, service implementation advertisements may include a “free form” parameter section that includes one or more implementation-dependent parameters.

In one embodiment, services may refer to each other (such as when obtaining the interface of another service from the group) by their class identifier.

In one embodiment, the same service specification may be used to perform more than one role in a group. For example, consider two instances of the same data base service with two completely different data set and purposes. To support this, it service class identifiers may be extended with a “role” suffix. In this embodiment, service class identifiers without a role suffix may accept a null role suffix as a valid role suffix. Thus, service class identifiers may be “roled”, and if “roleing” is never needed, only a short service class identifier may be needed.

In one embodiment, service specification identifiers may built from the class identifier of the class that the service specification implements. In one embodiment, only the base class UUID may be included so that service specification identifiers are unchanged by the addition of roles. This may be used, for example, to verify that a service specification does have the interface implied by the corresponding service class, regardless of the role for which it is used.

In one embodiment, service implementation advertisements may list compatibility requirements which may make them eligible to be loaded by a given group running in a given peer-to-peer platform implementation.

In one embodiment, groups, applications and endpoints may have similar constraints as services. For a group, the group specification may list the service specifications that this group supports. There may be one or more implementations, depending on various execution constraints. Endpoints and applications may function similarly or identically to services (i.e. groups, applications and endpoints may be considered “modules” as are services). Therefore, the mechanisms described above for services may also be used for groups, applications and endpoints.

In one embodiment, a peer group specification advertisement may include one or more of, but is not limited to, indications of services, endpoints and initial applications of the peer group. Similarly to how service implementations are correlated to service specifications by a service specification identifier, a peer group implementation may be correlated to a group specification by a unique identifier. This identifier may be referred to as a peer group identifier. A peer group specification may be a relatively large document. In one embodiment, since most of the peer group specification may only be needed if the group is to be instantiated, for publicizing a group, a peer group specification advertisement including only a name, an identifier, and one or more keywords may be used to publish a peer group. In one embodiment, to reduce the size of peer group specification advertisements, inheritance may be used between group definitions. Since most groups have a lot in common, a peer group specification advertisement may refer to another advertisement that may be common and therefore cached. The above approaches to reducing the size of peer group specification advertisements may be complementary.

In one embodiment, groups may load plug-in services according to the group's implementation. In one embodiment, service descriptions may not be required in a group advertisement. However, even if services are not implemented via plug-ins, the existence of services may be a property of the group that is visible “on the wire.” Therefore, peer group specification advertisements may list references to service specifications (e.g. the service specification identifier). In one embodiment, it may be the responsibility of a group's implementation to realize the services listed in the peer group specification advertisement by loading a supported implementation for each service, by implementing the service internally, or optionally using one or more other mechanisms. In one embodiment, the service realization mechanism(s) used is group implementation dependent.

In one embodiment, module (e.g. service) specification advertisements may not need to be downloaded in order to instantiate a group unless one of the module (e.g. service) implementations needs parameters from the module (e.g. service) specification. In one embodiment, module (e.g. service) specifications may be used by users when creating an implementation of the module (e.g. service).

In one embodiment, groups may need to uniquely identify each of their services, for example, to improve the robustness of demultiplexing service-addressed messages. Since each service in a group belongs to a service class, and no more than one service of each class may exist in a group, the combination of the group identifier and the service class identifier uniquely identify that service for service addressing purposes.

In one embodiment, services may bind to and use each other. In obtaining an interface to one of the other services, a service may use the other service's class identifier to designate this other service. Services “know” each other by their role; and therefore they designate each other by their class identifiers. For example, an implementation of a discovery service may know that it needs a “Resolver.”

In one embodiment, for each service, a group advertisement may list service specification identifiers for services of the group, since each service specification identifier includes a corresponding service class identifier. In one embodiment, to support roles, a group advertisement may optionally list an additional service class identifier for each service. This identifier may differ from that embedded in the specification identifier includes in that the former may have a role suffix and not the latter. In one embodiment, no two services may be assigned the same role in a given group.

In one embodiment, peer groups may have a variety of specifications, but may use a small number of implementations for the peer group API itself. The specification of the peer group functionality is the peer group specification advertisement, with its unique features and identifier. In one embodiment, to avoid publishing identical peer group implementation advertisements (except for the service specification identifier of the group) for each group, roles may be used. Similar to services, groups may come in a small family of APIs and behavior of the peer group class, and any number of roles for which they are used (e.g. in the case of a group, various communities of users). Therefore, the “role” model described for services may be extended to groups. There may be more than one class of group. Further, there may be roles in these group classes. In one embodiment, the role identifier may include the base class plus role suffix.

In one embodiment, a peer group specification advertisement may have two identifiers: the specification identifier that corresponds to the particular group service specification that is being used and the full class identifier (in one embodiment, including a role extension) that may be different for every group. In one embodiment, a service specification advertisement may include a class identifier in addition to a specification identifier, thereby specializing it for a given role (e.g. by changing parameters). In one embodiment, service specifications may be looked-up by their specification identifier, and service specifications may not be specialized for a role. In one embodiment, peer group specification advertisements may be looked-up by specification identifier and role identifier. In one embodiment, not specifying a role identifier when looking up a group may result in an error, but may be used for browsing purposes.

In one embodiment, specifying a group may require one or more of, but may not be limited to:

-   -   Identifiers:         -   A peer group identifier: Identifies the community built             around that group. May be turned into a full class             identifier when they become different from base class             identifiers.         -   A peer group specification identifier: Equivalent to a             service specification identifier. Identifies the behavior of             the Peer Group class (in the programming sense) being used,             not the community build around it.     -   Advertisements (may be optional or required):         -   Service class advertisement. In one embodiment, may be             required.         -   Peer group specification advertisement: Name, identifier,             the list of all services, etc. May be inherited from another             group. In one embodiment, may be required.         -   Peer group implementation advertisement: one implementation             of the code that drives the group. In one embodiment, may be             cached and reused. In one embodiment, may be required.         -   Peer Group Advertisement: an abbreviated publicizing of the             group. In one embodiment, may be optional.

In one embodiment, describing a service may require one or more of, but may not be limited to:

-   -   Identifiers:         -   Service class identifier: denotes functionality and an             expected API per supported binding (e.g., pipe, resolver,             discovery, etc.). In one embodiment, if there is no role             suffix (role=base class), this may be fully embedded in a             service specification identifier and therefore may need to             be repeated in the group advertisement.         -   Service specification identifier: denotes additional             on-the-wire behavior in providing a service defined by its             class (e.g., platform's pipe, intermittent pipe, reliable             pipe, etc.)     -   Advertisements:         -   Service class advertisement: describes a role and may             describe a per-platform set of APIs docs.         -   Service specification advertisement: describes a protocol             and behavior. In one embodiment, may be specialized for a             role.         -   Service implementation advertisement: describes an             implementation for a given platform. In one embodiment, may             be cached and reused.

In one embodiment, group identifiers may be constructed so that they are upward compatible with full class identifiers.

In one embodiment, there is one peer advertisement for each group instantiated on a peer. In one embodiment, a peer advertisement may describe only what is relevant to this group on this peer, in addition to describing the group. A peer advertisement may include one or more of, but is not limited to, one or more parameters that are particular to one given peer for each service, a peer identifier, name and keywords. In one embodiment, a peer advertisement may include only what needs to be published outside the peer, e.g. endpoint addresses, etc. In one embodiment, items that affect only the local behavior or that are not specified as being explicitly published (e.g. debug) may be left out of the peer advertisement and may go into an optional configuration document passed to the peer group object as an extra parameter. In one embodiment, in both the configuration document and the peer advertisement, variables may be related to services by the service class identifier; each setting may be a <Setting> element, tagged with a service class identifier. If there is no identifier, it means that the setting applies to all services of this group.

The following are two examples of layouts to list a service, and are not intended to be limiting: <Service>ServiceSpecID1</Service> and

<Service> <ServiceSpecID>ServiceSpecID1</ServiceSpecID> <ServiceClassID>ServiceClassID1</ServiceClassID> <SomeFOtherAttribute>whatever</SomeOtherAttribute> </Service>

Similar layouts may be used for other modules such as endpoints, applications and/or groups.

In one embodiment, peer groups may be defined by service specification advertisements with the group identifier equivalent to the role identifier. In this embodiment, the peer group advertisement may be an abbreviated version of the service specification. In another embodiment, services may be listed in the implementation advertisement for the group. In this embodiment, the implementation advertisement may refer to the peer group class used, with the parameter field listing the services. The group identifier may exist only in the peer group advertisement, which is the root definition of the group. Using this embodiment, there may be no need to obtain the specification advertisement of the group in order to instantiate it. This group advertisement includes the specification identifier of the group that is matched by that specification identifier in associated implementation advertisements, so that an implementation of the group may be acquired directly from the peer group advertisement without having to lookup the specification.

In one embodiment, the implementation advertisement of a service may be included in-line in the implementation advertisement of a group that uses it, rather than including the service's specification identifier.

As used herein, the term “module” includes the notion of any random code not part of the core system. In general, a module is a generic, loadable “thing” that has init( ), start( ) and stop( ) methods or their equivalents. Applications and services may be considered subclasses of modules. A service is a subclass of module that may have “get interface” and “get implementation advertisement” methods, making it suitable for registration with a group. In one embodiment, modules may also include code that has a known API and identity (its class identifier) and which can be looked-up with group lookup service.

In one embodiment, the peer configuration document may have the format of a peer advertisement. In one embodiment, the peer group API may include one or more methods that assist in loading modules, e.g. a “load module” method. In one embodiment, loading a peer group may be similar to loading any other module; one or more additional methods may be included to perform one or more tasks particular to loading a peer group.

In one embodiment, the definition of a group or other module (that is, the class that implements it for which binding, and with which parameters), is immutable. The information about the group or other module's instantiation on a peer (e.g. everything that may be different on each peer, such as endpoint addresses, rendezvous status, etc) may been separated into a different advertisement: the peer advertisement.

In one embodiment, there may be one or more parameters that are private to a peer and essentially the result of a choice by the user or defaults that depend on the particular peer that instantiates that module or group (e.g. local network interfaces, well-known rendezvous, etc.). These may be similar to the content of a peer advertisement, but may not be published (or alternatively, if published, it is by the decision of the module and copied by that module to the peer advertisement). The document that includes these unpublished parameters may be a peer advertisement that may be passed as an argument to the module's init routine. In one embodiment, providing the peer advertisement as an argument may be optional.

The following is an exemplary initialization routine for modules and is not intended to be limiting: init(group, assignedID, implAdv, configAdv); where:

-   -   Group: The group that provides the peer-to-peer platform API to         this module: If the module is a group, this is its parent group.         If this module is a service, group is the group of which this         service is a part. If the module is an application, group is the         group within which this application runs.     -   assignedID: assigned identifier. A unique identifier assigned to         this module by its group. If this module is a group, the         assigned identifier is its group identifier. If this module is a         service, then this is the full class identifier of that service         in that group. In one embodiment, the full class identifier         listed in the group's implementation advertisement may be used.         In one embodiment, if this module is a main application of a         peer group, then its assigned identifier may be a full class         identifier of the base class application. In one embodiment, the         role part may be assigned randomly in order to be unique.         Otherwise, in one embodiment, it may be anything, including         null. In one embodiment, a service may find its configuration         parameters indexed under its assigned identifier in the         configuration advertisement, and may update its published         parameters under its assigned identifier in the peer         advertisement.     -   implAdv: the implementation advertisement from which this module         was loaded. In one embodiment, if this module is a subclass of a         standard (base) peer group class, then the <Parm> section of         this advertisement may include a complete list of the services         that this group includes. If the module is an application, the         module may have been loaded directly from its class, bypassing         the implementation advertisement lookup. As a result, there may         not be an implementation advertisement available, in which case         “null” may be passed for this argument. In one embodiment, the         standard peer group may pass an implementation advertisement to         the main application(s).     -   configAdv: the configuration advertisement for this module. As         for assigned identifier and implementation advertisement, this         may be null if the module is an application. In one embodiment,         the standard peer group may pass its configuration advertisement         through to the main application(s).

One embodiment may include an initialization routine for modules in order to avoid resorting to reflection when loading and initializing modules. In one embodiment, modules may only include a default constructor, and the initialization routine is a substitute to having a constructor with parameters. The initialization routine, followed by a start application routine gets the module running. In one embodiment, a “stop application” routine may shut down that module. In one embodiment, after calling the stop application routine, the module may be unreferenced and garbage collected. To resume running the module, the module may be loaded from scratch again.

One embodiment may include a “start application” routine in addition to an initialization routine in order to be able to operate on the module once its is fully constructed but before it starts running. What “starts running” means may be defined by each module in relation to the effects of whichever methods the particular module provides that affect its behavior.

In one embodiment, services may be registered with the peer group upon returning from the init routine. In this embodiment:

-   -   Services may be ready to have their public methods invoked upon         returning from the initialization routine. In one embodiment,         the services may not be obligated to provide full functionality.         Public methods preferably fail nicely if they cannot perform         fully.     -   Services may expect all other services of the group to be         available from the group's registry upon their start application         method being invoked, and to have the public methods of these         services either fully work or fail nicely.     -   In one embodiment, both the initialization and the start         application methods of a module may be required to “return.” In         other embodiments, either one or both of these methods may not         be required to return.         Exemplary Peer-to-Peer Platform

Embodiments of an open network computing platform designed for peer-to-peer computing are described. The network computing platform may be referred to as a peer-to-peer platform. The peer-to-peer platform may be used to build a wide range of distributed services and applications in which every device is addressable as a peer, and where peers can bridge from one domain into another. The peer-to-peer platform may enable developers to focus on their own application development while easily creating distributed computing software that is flexible, interoperable, and available on any peer on the expanded Web. The peer-to-peer platform may enable software developers to deploy interoperable services and content, further spring-boarding the peer-to-peer revolution on the Internet. The peer-to-peer platform addresses the problems of prior art peer-to-peer systems by providing a generic and service-agnostic peer-to-peer platform that may be preferably defined by a small number of protocols. Each protocol is preferably easy to implement and easy to be adopted into peer-to-peer services and applications. Thus, service offerings from one vendor may be used, perhaps transparently, by the user community of another vendor's system.

The peer-to-peer platform extends P2P computing to enable a wide range of distributed computing applications and overcome the limitations typically found in prior art P2P applications. The peer-to-peer platform is a network computing technology that provides a set of simple, small, and flexible mechanisms that can support P2P computing on any platform, anywhere, and at any time. The peer-to-peer platform generalizes P2P functionality and provides core technology that addresses the limitations of prior art P2P computing technologies.

The peer-to-peer platform is a modular platform that provides simple and essential building blocks for developing a wide range of distributed services and applications. The peer-to-peer platform specifies a set of protocols rather than an API. Thus, the peer-to-peer platform can be implemented in any language on any Operating System to provide solutions ranging from providing a simple protocol-based wrapper that enables a small device to join a network of peers to developing a fully integrated application that supports metering, monitoring, high-level security and communication across server-class systems.

In one embodiment, the peer-to-peer platform architecture may include, but is not limited to, protocols, advertisements, and core services. Network protocol bindings may be used to preferably ensure interoperability with existing content transfer protocols, network transports, routers, and firewalls. The peer-to-peer platform may be used to combine network nodes (peers) into a simple and coherent peer-to-peer network computing platform. The platform is preferably directed at providing several benefits including, but not limited to, no single point of failure, asynchronous messaging, the ability for peers to adapt to their network environment, and moving content towards its consumers.

FIG. 10 illustrates one embodiment of peer-to-peer platform software architecture at the conceptual level. The peer-to-peer platform may include several layers. In one embodiment, the software stack may be described using three layers; a peer-to-peer platform (core) layer 120, a service layer 140 and an application layer 150. In one embodiment, the peer-to-peer platform may include a core layer 120 that defines and encapsulates minimal primitives that are common to peer-to-peer networking, including, but not limited to, peers 110, peer groups 122, peer discovery 124, peer communication (e.g. pipes) 126, peer monitoring 128, and associated security primitives 130. This layer may be shared by all peer-to-peer devices so that interoperability becomes possible.

A peer may be defined as any entity that runs some or all of one or more protocols provided by the peer-to-peer platform core layer. As such, a peer may manifest in the form of a processor, a process or a device. A peer may be anything with a digital heartbeat that supports the peer-to-peer platform core, including sensors, servers, PCs, computers up to and including supercomputers, PDAs, manufacturing and medical equipment, phones and cellular phones. In order to interact with other peers (e.g. to form or join peer groups), the peer needs to be connected to some kind of network (wired or wireless), such as IP, Bluetooth, or Havi, among others.

The peer-to-peer platform may provide mechanisms through which peers may discover each other, communicate with each other, and cooperate with each other to form peer groups. Peers may discover each other on the network to form transient or persistent relationships called peer groups. A peer group is a collection of peers connected by a network that share a common set of interests and that have agreed upon a common set of rules to publish, share and access any computer content (code, data, applications, or other collections of computer representable resources), and communicate among themselves. Peer groups may also be statically predefined. The peers in a peer group may cooperate to provide a common set of services. A peer group may be viewed as an abstract region of the network, and may act as a virtual subnet. The concept of a region virtualizes the notion of routers and firewalls, subdividing the network in a self-organizing fashion without respect to actual physical network boundaries. In one embodiment, peer groups implicitly define a region scope that may limit peer propagation requests. Conceptually, a peer group may be viewed as a virtual entity that speaks the set of peer group protocols.

A peer group may theoretically be as large as the entire connected universe. Naming anything uniquely is a challenge in such a large namespace. In one embodiment, the peer-to-peer platform may support and/or provide sophisticated naming and binding services. In one embodiment, the peer-to-peer platform may use a universal unique identifier (UUID), for example, a 64- or 128-bit datum, to refer to an entity or resource (e.g. a peer, peer group, service, application, pipe, advertisement, endpoint, content, etc.). For example, UUIDs may be embedded in advertisements for internal use.

UUIDs provide unique identifiers for resources in the peer-to-peer environment, and preferably identify the resource independently of the resource's location on the network. A UUID may be bound to other information, such as a network address of the corresponding resource and/or a resource name of the resource. Thus, UUIDs help to provide peers, services and other peer-to-peer environment entities with access to resources in the peer-to-peer environment independent of the resources' locations.

UUIDs preferably may be used to guarantee that each resource or entity has a unique UUID within a local runtime environment and serves as a canonical way of referring to an entity, but because a global state is not assumed, it may not be possible to provide a guarantee of uniqueness across an entire community that may consist of millions of peers. This may not be a problem because a UUID may be used within the peer-to-peer platform as an internal identifier. This may become significant only after the UUID is securely bound to other information such as a name and a network address.

The UUID is an abstract data structure, and thus virtually any canonical method may be used for representing UUIDs for use in peer-to-peer environments. In one embodiment, different peer groups may implement different canonical representations of UUIDs in the same peer-to-peer environment. In one embodiment, Uniform Resource Name (URN) format may be used for the representation of UUIDs. In one embodiment, Uniform Resource Identifier (URI) format may be used. In one embodiment, Uniform Resource Locator (URL) format may be used. In one embodiment, custom and/or proprietary methods of representing UUIDs may be used. For example, one peer group may use URN format for UUIDs, and another peer group may use a proprietary alphanumeric naming scheme.

The core layer 120 provides core support for peer-to-peer services and applications. In a multi-platform, secure execution environment, the core mechanisms of peer groups, peer pipes and peer monitoring may be provided. Peer groups 122 may establish a set of peers and naming within a peer group with mechanisms to create policies for creation and deletion, membership, advertising and discovery of other peer groups and peer nodes, communication, security, and content sharing. Pipes provide virtual communication channels among peers. Messages sent in pipes may support transfer of data, content, and code in a protocol-independent manner, allowing a range of security, integrity, and privacy options. In one embodiment, messages may be structured with a markup language such as XML. Peer monitoring 128 enables control of the behavior and activity of peers in a peer group and can be used to implement peer management functions including access control, priority setting, traffic metering, and bandwidth balancing.

The core layer 120 may include protocols and building blocks to enable key mechanisms for peer to peer networking, including discovery, transport (including firewall handling and limited security), and the creation of peers and peer groups. The core layer 120 is preferably thin and small, and preferably provides interesting and powerful primitives for use by services and applications in the other layers. The core layer 120 may support choices such as anonymous vs. Registered users and encrypted vs. Clear text content without imposing specific policies on developers. Policy choices may be made, or when necessary, implemented, at the service layer 140 and/or application layer 150. For example, administration services such as accepting or rejecting a peer's membership in a peer group may be implemented using the functionality provided by the core layer 120.

The core components of the peer-to-peer protocol may be used to implement discovery mechanisms for searching, publishing and recovering of core abstractions (e.g. peers, peer group, pipes, endpoints, and advertisements). These mechanisms are preferably simple, administration free, and do not require special peers to act as “master” peers. These mechanisms may allow processes in the peer-to-peer network, in absence of help from other applications and/or services, to bootstrap and find out the information necessary to access applications and services that can help. Also, the core may “return” to this standalone behavior and still function if helper applications or services fail. In one embodiment, safety mechanisms may be put in place in order to avoid a major overflow of “web-crawling”. In one embodiment, applications and/or services that support the peer-to-peer protocol may access, control, and/or override the core components, even to the extreme of implementing a centralized, client-server model based on the core components.

At the highest abstraction level, the peer-to-peer platform may be viewed as a set of protocols provided at the core layer 120. In one embodiment, a common thread among peer-to-peer platform peers is protocols, not APIs or software implementations. The peer-to-peer platform protocols preferably guarantee interoperability between compliant software components executing on potentially heterogeneous peer runtimes. Thus the peer-to-peer platform is preferably agnostic to programming languages. The term compliant may refer to a single protocol only. That is some peers may not implement all the core protocols. Furthermore, some peers may only use a portion (client-side or server-side only) of a protocol.

Each protocol may be defined by one or more messages exchanged among participants of the protocol. Each message may have a predefined format, and may include various data fields. In one embodiment the protocols may utilize messaging such as XML messages. The peer-to-peer platform connects peer nodes with each other. The peer-to-peer platform is preferably platform-independent by virtue of being a set of protocols. As such, the peer-to-peer platform may not require APIs and remains independent of programming languages, so that it can be implemented in C/C++, Java, Java 2ME, Perl, Python or other languages. This means heterogeneous devices with completely different software stacks can preferably interoperate through the peer-to-peer platform protocols. To underpin this set of protocols, the peer-to-peer platform may define a number of concepts including peer, peer group, advertisement, message, pipe, and more.

In one embodiment, peer-to-peer protocols may be embodied as markup language (e.g. XML) messages that may be sent between two peers. In one embodiment, the peer-to-peer platform messages may define the protocols used to discover and connect peers and peer groups, and to access resources offered by peers and peer groups, among others. The use of markup language (e.g. XML) messages to define protocols may allow many different kinds of peers to participate in a protocol. Each peer may be free to implement the protocol in a manner best suited to its abilities and role. For example, not all peers are capable of supporting a Java runtime environment. In one embodiment, the protocol definition does not require nor imply the use of Java on a peer.

Several peer-to-peer platform protocols that may be provided by embodiments of the peer-to-peer platform are described later in this document. The protocols defined in this document may be realized over networks including, but not limited to, the Internet, a corporate intranet, a dynamic proximity network, a home networking environment, LANs, and WANs. The protocols defined in this document may also be realized within a single computer. Thus, the peer-to-peer platform is preferably transport protocol independent. The size and complexity of the network peers that may support these protocols preferably includes a wide range of peer implementations including peers implemented on, but not limited to, simple light switches, PDAs, cell phones, pagers, laptop and notebook computers, smart appliances, personal computers, workstations, complex, highly-available servers, mainframe computers and even supercomputers.

The peer-to-peer platform may further include a peer-to-peer services layer 140. This layer may provide capabilities that may not be absolutely necessary for a peer-to-peer network to operate but that may be desirable to provided added functionality beyond the core layer 120 in the peer-to-peer environment. The service layer 140 may deal with higher-level concepts such as search and indexing, directory, storage systems, file sharing, distributed file systems, resource aggregation and renting, protocol translation, authentication and PKI (public key infrastructure) systems. These services, which may make use of the protocols and building blocks provided by the core layer 120, may be useful by themselves but also may be included as components in an overall P2P system. Thus, services may include one or more services 144 provided by the peer-to-peer platform. These platform-provided services 144 may include indexing, searching and file sharing services, for example. The services layer 140 may provide hooks for supporting generic services (such as searching, sharing and added security) that are used in many P2P applications. Thus, services may also include one or more services 142 not provided as part of the peer-to-peer platform but rather provided by the peer-to-peer platform community. These services 142 may be user-defined and may be provided, for example, to member peers in a peer group as a peer group service.

Services may expand upon the capabilities of the core layer 120 and may be used to facilitate application development. Facilities provided as services in the service layer 140 may include mechanisms for search and indexing, directory, storage systems, file sharing, distributed file systems, resource aggregation and renting, protocol translation, authentication, PKI services, and caching code and content to enable cross-application bridging and translation of files, among others. Searching capabilities may include distributed, parallel searches across peer groups that are facilitated by matching an XML representation of a query to be processed with representations of the responses that can be provided by each peer. These facilities may be used for simple searches, for example searching a peer's repository, or more complex searches of dynamically generated content that is unreachable by conventional search engines. P2P searches may be conducted across a company's intranet, for example, to quickly locate relevant information within a secure environment. By exercising tight control over peer group membership and enabling encrypted communication between peers, a company may extend this capability to its extranet, including business partners, consultants, and suppliers as peers. The same mechanisms that facilitate searches across the peer group may be used as a bridge to incorporate Internet search results, and to include data outside of the peer's own repository, for example searching a peer's disk. The peer services layer 140 may be used to support other custom, application-specific functions. For example, a secure peer messaging system may be built to allow anonymous authorship and a persistent message store. The peer services layer 140 provides the mechanisms to create such secure tools; the application developers themselves may determine specific tool policies.

The peer-to-peer platform may also include a peer-to-peer application layer 150. The application layer 140 may support the implementation of integrated applications such as file sharing, resource sharing, monetary systems, distributed storage, peer-to-peer instant messaging, entertainment, content management and delivery, peer-to-peer email systems, distributed auction systems, among others. Applications may be “vertical” or they may be developed to interoperate with other distributed applications. One or more applications 154 may be provided as part of the peer-to-peer platform. For example, one embodiment of the peer-to-peer platform may include a shell application 160 as a development environment built on top of the platform. The shell application may provide interactive access to the peer-to-peer platform via a simple command line interface 162.

Applications may also include community applications 152 not provided by the peer-to-peer platform. These community applications 152 may be user-defined and may be provided, for example, to member peers in a peer group as a peer group application.

In one embodiment, the boundary between services and applications is not rigid. An application to one customer can be viewed as a service to another customer. An application may use services. Services may serve as protocols that may be shared among various applications. An application may provide a user interface, a way to define a set of files to share, a way to initiate a search, a way to display the results, and a way to initiate a file transfer, for example. Such an application may make use of a set of services, for example a reliable point-to-point file transfer service, a distributed search service, a discovery service to locate other peers, among others.

Applications may be built using peer services as well as the core layer 120. The peer-to-peer platform may support the fundamental levels broadly, and rely on the P2P development community to provide additional peer services and applications. Peer applications enabled by both the core layer 120 and peer services layer 140 may include P2P auctions that link buyers and sellers directly, with buyers able to program their bidding strategies using a simple scripting language, for example. Resource-sharing applications, such as SETI@home, may be built more quickly and easily, with heterogeneous, worldwide peer groups supported from day one. Instant messaging, mail, and calendaring services may facilitate communication and collaboration within peer groups that are secure and independent of service provider-hosted facilities. Virtually any other type of application may be build on top of the core layer 120 and services layer 140.

Some features, such as security, may manifest in all three layers and throughout a P2P system, albeit in different forms according to the location in the software architecture. The system is preferably modular, and allows developers to pick and choose a collection of services and applications that suits their needs.

A typical peer-to-peer platform network may provide an inherently nondeterministic topology/response structure. In a peer-to-peer platform network, a specific resource request may not return for minutes, hours, or even days; in fact, it may never return at all. In addition, people from different parts of the world requesting the same resource are likely to get different copies of the resource from completely different locations. Peers may obtain content from multiple servers, ideally reaching a nearby one that is up and running. The original source peer need not service every resource request; in fact, it does not even have to be up and running. The nondeterministic structure may also help provide the optimized use of network bandwidth. The concentrated localized traffic congestion typical of today's Web doesn't affect P2P networking. The nondeterministic structure may also help provide a lowered cost of content distribution. The P2P network can absorb contents and replicate it for easy access. The nondeterministic structure may also help provide leveraged computing power from every node in the network. With asynchronous operations, a user may issue many requests for many resources or services simultaneously and have the network do the work. The nondeterministic structure may also help provide unlimited scalability. A properly designed P2P application may span the entire known connected universe without hitting scalability limits; this is typically not possible with centralized schemes. Note, however, that the peer-to-peer platform also may support deterministic, synchronous applications.

As an example of a nondeterministic, asynchronous application, consider a network-based music request service that operates over a peer-to-peer platform-based P2P network. A peer submits multiple requests for music files and then checks back later to see if the music request service in the peer group has found them. A few requested files have been found, but others cannot be located. The service's response in regards to the files that cannot be located may be something like “Music selection and availability changes continuously; please retry your request later.” This is an acceptable nondeterministic outcome. Even though the service couldn't find a file, the same file may be available later if the same request is resubmitted, because peers that host the desired files may have come online in the meantime.

The peer-to-peer platform provides the ability to replicate information toward end users. Popular content tends to be replicated more often, making it easier to find as more copies are available. Peers do not have to always go back to the same peer to obtain the information they want, as is typical in the client/server model. Peers may obtain information from neighboring peers that have already cached the information. Each peer may become a provider to all other peers.

In one embodiment the peer-to-peer platform may enable peers to find content that is closest to them. This content may include data (e.g. files) or even services and applications. For example, if a peer node in an office peer-to-peer network using the peer-to-peer platform is moved, the peer-to-peer platform may allow the peer to automatically locate content (e.g. using a discovery service that participates in the discovery protocol) including services (e.g. a printer service and an email service) hosted by other peers closest to the peer's new location, without requiring any manual reconfiguration. Further, at least some content may be copied or moved to the peer in its new location and/or to other peers proximate to the new location.

In one embodiment, the UUIDs may be used in providing flexible configuration and seamless relocation of peer nodes on a peer-to-peer network, and may assist in locating and accessing content including services nearest to a peer node when the peer node is moved. For example, a businessperson based in New York may participate in a peer-to-peer network based on the peer-to-peer protocols using a notebook computer or other portable computing device connected to a LAN as a peer node. The businessperson may access an instance of an email and/or other services locally hosted by other peer nodes in a peer group on the LAN. If the businessperson travels to Paris, for example, and takes the notebook computer, the notebook computer may be connected to a different LAN at the Paris location and participate in the peer-to-peer network. Because the peer node has a unique identifier in the peer-to-peer network (e.g. a UUID) rather than just a static network address (the unique identifier may be bound to the static network address), the peer node may seamlessly access instances of an email service and other services locally hosted on the LAN, or alternatively hosted on a peer node at the peer node's original location or elsewhere, using the UUID to establish its identity. The peer node may rejoin the peer group in New York to access one or more instances of services and other content hosted on the peer group, and may also join a peer group at the Paris location to access one or more other instances of services and content. Thus, the peer-to-peer protocols and UUIDs may provide the ability for peer nodes to move to different peer groups and/or peer regions and access services and other content independent of network addresses and without requiring reconfiguration of the peer node. For example, when the exemplary peer node moves to Paris, connects to the network (at a different network address) and accesses an instance of an email service (either locally or remotely hosted, for example in the New York peer group), the email service may identify the peer node by its unique identifier and route the peer's email to the peer node at the new network address without requiring reconfiguration of the peer node. Thus, peer nodes may be relocated and access services and other content that are locally hosted or services and other content hosted in their original peer group if the services and other content are not required to be locally hosted.

The peer-to-peer platform preferably provides a decentralized environment that minimizes single points of failure and is not dependent on any centralized services. Both centralized and decentralized services may be developed on top of the peer-to-peer platform. With the addition of each new network peer, the network platform preferably becomes more robust as it expands. In the environment, services may be implemented to interoperate with other services giving rise to new P2P applications. For example, a P2P communications service like instant messaging may easily be added to a resource-sharing P2P application if both support at least the necessary peer-to-peer platform protocols.

The peer-to-peer platform may provide interoperability. The peer-to-peer platform may be used by developers independent of preferred programming languages, development environments, or deployment platforms. Embodiments of the peer-to-peer platform may enable interconnected peers to easily locate each other, communicate with each other, participate in community-based activities, and offer services to each other seamlessly across different P2P systems and different communities. The peer-to-peer platform may also provide platform independence. Embodiments of the peer-to-peer platform may be independent of programming languages (such as C/C++, Java, Perl, and KVM), system platforms (such as the Microsoft Windows, UNIX®, Solaris, Linux and Macintosh platforms), and networking platforms (such as TCP/IP, Bluetooth and Havi). Thus, heterogeneous devices with completely different software stacks may interoperate through the peer-to-peer platform protocols. Embodiments of the peer-to-peer platform may be implementable on any device with a digital heartbeat, including, but not limited to, sensors, consumer electronics, Personal Digital Assistants (PDAs), appliances, network routers, desktop computers, data-center servers, and storage systems. Embodiments of the peer-to-peer platform may enable peers, independent of software and hardware platform, to benefit and profit from being connected to millions of other peers.

In one embodiment, the peer-to-peer platform may run on any of various operating systems including embedded operating systems (with the appropriate level of Java runtime support, if required) such as Windows95, 98, 2000, ME, and NT, Solaris, Unix, Macintosh, Linux, Java 2 Platform, Micro Edition (J2ME) and PersonalJava Technology. The peer-to-peer platform may be implemented in any of a variety of development environments using any of a variety of programming languages, or combinations of programming languages, including, but not limited to, Java, Java 2ME, C/C++, Perl, Python and KVM. In one embodiment, the peer-to-peer platform may be implemented in Java. In one embodiment, a peer-to-peer platform may be implemented in C/C++ on some devices, for example, to support devices without Java support. In one embodiment, a peer-to-peer platform may be implemented in KVM on some devices, for example, so that all KVM capable devices such as PDAs and cell phones can be peer-to-peer platform peers. Programming languages other than those listed may also be used in various embodiments.

A minimal device with the ability to generate a text string may theoretically participate in a peer-to-peer platform network (though not necessarily in every P2P application). The simplistic device may need a surrogate peer on the P2P network. This surrogate peer may perform discovery, advertisement, and communications on behalf of the simplistic device (or many simplistic devices). The location of the surrogate may be hard-wired into the simplistic device. In this way, the simplistic device with the help of the surrogate can be a full-fledged peer on the peer-to-peer platform network. For example, a GPS locator, strapped to a sea turtle and sending out peer-to-peer platform messages wirelessly with location information, may become a peer on a peer-to-peer platform network.

The peer-to-peer platform is preferably independent of transport protocols. For example, the peer-to-peer platform may be implemented on top of TCP/IP, HTTP, Bluetooth, HomePNA, and other protocols. Thus, a system built on top of the peer-to-peer platform preferably functions in the same or similar fashion when the system is expanded to a new networking environment or to a new class of devices, as long as there is a correct transport protocol handler for the new networking protocol.

In one embodiment, the peer-to-peer platform may use XML as the encoding format. XML may provide convenience in parsing and extensibility. Other embodiments of the peer-to-peer platform may use other encoding formats. The use of XML does not imply that all peer-to-peer platform peer nodes must be able to parse and to create XML documents. For example, a cell phone with limited resources may be programmed to recognize and to create certain canned XML messages and can still participate in a peer-to-peer platform network of peers. In one embodiment, a lightweight XML parser may be used that supports a subset of XML. This may help reduce the size of the peer-to-peer platform.

There may be areas in a peer-to-peer environment where there is not one correct way to do something or where what should be done depends on the nature and context of the overriding application. For example, in the area of security, every P2P application may choose a different authentication scheme, a different way to ensure communication security, a different encryption algorithm for data security, a different signature scheme for authenticity, and a different access control policy. Therefore, for these areas, the peer-to-peer platform may preferably focus on mechanisms instead of policy, so that application developers can have the maximum freedom to innovate and offer competitive solutions.

Implementations of the peer-to-peer platform may be illustrated with a few application or usage scenarios. For example, assume there is a peer-to-peer community offering a search capability for its members, where one member can post a query and other members can hear and respond to the query. One member is a Napster user and has implemented a feature so that, whenever a query is received seeking an MP3 file, this member will look up the Napster directory and then respond to the query with information returned by the Napster system. Here, a member without any knowledge of Napster may benefit because another member implemented a bridge to connect their peer-to-peer system to Napster. The peer-to-peer platform may provide a platform bridge that may be used to connect the various peer-to-peer systems together.

In another example, one engineering group requires a sizable storage capability, but also with redundancy to protect data from sudden loss. Using the peer-to-peer platform, each group may buy a simple storage system without a mirroring feature, where the disks can then discover each other automatically, form a storage peer group, and offer mirroring facilities using their spare capacity.

As yet another example, many devices such as cell phones, pagers, wireless email devices, Personal Digital Assistants (PDAs), and Personal Computers (PCs) may carry directory and calendar information. Using the peer-to-peer platform, these devices may be able to interact with each other, without extra networking interfaces except those needed by the devices themselves, using the peer-to-peer platform as the common layer of communication and data exchange.

Peers

Network nodes (peers) of various kinds may join the peer-to-peer networking platform by implementing one or more of the platform's protocols. Each peer operates independently and asynchronously of any other peer, providing a degree of reliability and scalability not typically found in current distributed systems. Some peers may have more dependencies with other peers due to special relationships (e.g. gateways or routers). In one embodiment, a peer does not need to understand all of the protocols of the peer-to-peer platform. The peer can still perform at a reduced level if it does not support one or more of the protocols.

Peers may publish and provide network resources (e.g. CPU, storage and routing resources) that may be used by other peers. Peers typically interact with a small number of other peers (network neighbors or buddy peers). Peers that provide the same set of services tend to be inter-changeable. Thus, it may not matter which peers a peer interacts with. Generally, assumptions should not be made about peer reliability or connectivity, as a peer may appear or leave the network at any time. Peers may have persistent storage. A peer may optionally cache information.

Peers may have multiple network interfaces, though preferably a peer does not need to publish all of its interfaces for use with the peer-to-peer protocols. Each published interface may be advertised as a peer endpoint. In one embodiment, a peer endpoint is an identifier (e.g. a URN or URI) that uniquely identifies a peer network interface. Peer endpoints may be used by peers to establish direct point-to-point connection between two peers. Peers may not have direct point-to-point network connection between themselves, either due to lack of physical network connections, or network configuration (NATs, firewalls, proxies, etc.), and thus a peer may have to use one or more intermediary peers to route a message from an endpoint to another peer endpoint.

The term rendezvous peer may be used to designate a peer that is designated to be a rendezvous point for discovering information about other peers, peer groups, services and pipes. Rendezvous peers preferably cache information that may be useful to peers including new peers. Rendezvous peers may provide an efficient mechanism for peers that are far away to find (e.g. discover) each other. Rendezvous peers may make peer discovery more practical and efficient. Preferably, a peer group is not required to have a rendezvous peer. In one embodiment, any or even all members of a peer group may become rendezvous peers in a peer group. In one embodiment, each peer group may have different policies to authorize a peer to become a rendezvous peer.

The term router peer may be used to describe a peer that crosses one or more regions and is designated to be a router between the regions. Router peers may be used to route messages between different network protocols (e.g. TCP/IP, IrDA) or to peers that are behind firewalls. In one embodiment, any or all peer members may become routers. In one embodiment, peer groups may have different policies to authorize a peer to become a router peer for other peers.

In one embodiment, every peer in the peer-to-peer network may have a unique peer identifier (e.g. UUID). Other peer-to-peer network resources may also have unique identifiers, including peer groups, services, applications, pipes, endpoints, content and resource advertisements. In one embodiment, the peer identifier may identify a peer group in which the peer is a member peer. In one embodiment, a peer may have a different peer identifier for each group in which it is a member peer. A peer identifier that also identifies a peer group in which the peer is a member peer may be used to differentiate peers that seek access to a service or content on a peer within the peer group. For example, as illustrated in FIG. 44, a peer 200A may provide implementations of a service in two or more different peer groups in which it is a member peer. In this illustration, peer 200A is a member peer in peer groups 210A and 210B. The peer 200A may advertise a different peer identifier within each peer group, and may differentiate between messages received from peers in the different peer groups by examining their respective peer identifiers to identify the particular peer group in which the peers that sent the messages are member peers to determine which service implementation to provide to the requesting peers. In this example, peer 200A provides service implementation 400A for peers in peer group 210A and service implementation 400B for peers in peer group 210B. When peer 200A receives a message for the service from peer 200C, which is a member peer in peer group 210B, peer 200A may examine the peer identifier of peer 200C, included in the message, to determine which peer group peer 200C is in. After determining, peer 200A may route the message to the correct service implementation, in this example service implementation 400B.

Peers may be identified by their unique identifier (UUID) rather than by a fixed address. When a peer boots, it attempts to contact other peers. In one embodiment, contacted peers may include variable-sized caches that map nearby peers' UUID to their current addresses. This allows embodiments of the peer-to-peer platform to be run over a dialup connection, for example.

FIG. 45 is a flowchart illustrating a method for assigning unique identifiers to peers in a peer-to-peer networking environment according to one embodiment. A plurality of peers may cooperate to form a peer-to-peer environment in accordance with the peer-to-peer platform as described herein as indicated at 420. Each of the peers may be assigned a unique peer identifier that may be used to distinguish the peer from other peers in the peer-to-peer environment as indicated at 422. One of the peers may identify and access another one of the peers using the other peer's unique peer identifier as indicated at 424.

The peer identifiers may be included in resource advertisements of resources associated with the peers. For example, the peer identifiers may be included in peer advertisements, peer group advertisements, service advertisements, pipe advertisements and endpoint advertisements, among others. In one embodiment, a peer identifier may be bound to a network address (e.g. IP address, URI, URN or URL) of the peer. If the peer changes network addresses (e.g. is moved to a new network location), the peer identifier may be unbound from the network address and bound to the new network address. Thus, the peer identifier provides a dynamic identification and addressing mechanism for peers in the peer-to-peer network, rather than a static mechanism, allowing peers to change network locations and still be identifiable (e.g. in peer groups the peer is a member peer of) using the same peer identifier.

In one embodiment, the peer identifier may include information identifying a particular peer group the peer is a member peer of. In one embodiment, a peer may be assigned a different, unique peer identifier for each peer group the peer is a member peer of. In one embodiment, peer identifiers may be included in messages received from other peers. If the receiving peer is a member in more than one peer group, the receiving peer may use the peer identifiers received in the messages to identify particular implementations of resources (e.g. services, pipes, endpoints and content) that are available for access by the sending peers.

FIG. 46 is a flowchart illustrating a method for assigning unique identifiers to resources in a peer-to-peer networking environment according to one embodiment. A plurality of peers may each host one or more resources in the peer-to-peer environment as indicated at 430. At least a portion of the resources may each be assigned a unique resource identifier as indicated at 432. A peer wishing to access a resource may specify the resource using the resource's identifier as indicated at 434.

The resource identifiers may be included in resource advertisements for the resources. At least a portion of the resource identifiers may be bound to a network address (e.g. IP address, URI, URN or URL) corresponding to the resource. At least a portion of the resource identifiers may also specify a particular peer and/or peer group that hosts the resource. Resources may include, but are not limited to, peers, peer groups, services, applications, advertisements, content, pipes and pipe endpoints.

In one embodiment, a peer may be assigned a unique string as a name. Any naming scheme may be used. In one embodiment, names are not unique unless a coordinated naming service is used to guarantee name uniqueness. A naming service is typically a centralized service that guarantees the uniqueness of name and can be used to register name mapping. Examples of naming services are DNS and LDAP. Use of a naming service is preferably optional.

Peer Groups

Preferably, the peer-to-peer platform describes how to create and discover peer groups, but does not dictate when, where, or why to create a peer group, the type of the group, or the membership of the group. A peer group may provide a common membership definition. Each peer group may establish its own membership policy in a range from open (any peer can join) up to highly secure and protected (a peer may join only if it possesses sufficient credentials).

In one embodiment, peers wishing to join a peer group may first locate a current member, and then request to join the peer group. The peer-to-peer platform may define how to discover peer groups, e.g. using a peer discovery protocol. The application to join may be rejected or accepted by the collective set of current members in accordance with the peer group's membership policy. In one embodiment, a peer group core membership service may be used to enforce a vote among one or more group members. Alternatively, one or more group representative member peers may be elected or appointed to accept or reject new membership applications.

In one embodiment, the peer-to-peer platform is not concerned with what sequence of events a peer or a peer group comes into existence. Moreover, in one embodiment, the peer-to-peer platform does not limit how many groups a peer can belong to. In one embodiment, nested and/or overlapping peer groups may be formed. In one embodiment, there may be a special group, called the World Peer Group, which may include all peer-to-peer platform peers. The world peer group preferably provides the minimum seed for every peer to potentially find each other and form new groups. In one embodiment, the world peer group has an open membership policy (e.g. has a null membership authenticator service). Some peers inside the world peer group may not be able to discover or communicate with each other—e.g., they may be separated by a network partition. In one embodiment, participation in the World Peer Group is by default.

The peer-to-peer platform may use the concept of a peer group as an implicit scope of all messages originated from within the group. Peer groups may serve to subdivide the network into abstract regions providing an implicit scoping mechanism. Peer groups may provide a limited scoping environment to ensure scalability. Peer groups may be formed and self organized based upon the mutual interest of peers. In one embodiment, no particular rules are imposed on the way peer groups are formed, but peers with the same interests may tend to join the same peer groups.

In one embodiment, a scope may be realized with the formation of a corresponding peer group. Peer group boundaries may define the search scope when searching for a group's content. For example, a peer in San Francisco looking to buy a used car is normally not interested in cars available outside of the Bay Area. In this case, the peer may want to multicast a message to a subset of the current worldwide peer group, and a subgroup may be formed especially for this purpose. In one embodiment, the multicast may be done without the formation of a new peer group. In one embodiment, all messages may carry a special scope field, which may indicate the scope for which the message is intended. Any peer who receives this message may propagate the message based on the scope indicator. Using this approach, it is preferable that a sending peer is bootstrapped with some well-defined scopes and also has the ability to discover additional scopes.

Peer groups may also be formed based upon the proximity of the member peers. Proximity-based peer groups may serve to subdivide the network into abstract regions. Regions may serve as a placeholder for general communication and security configurations that deal with existing networking infrastructure, communication scopes and security requirements. Peer groups may provide a scoping mechanism to reduce traffic overload.

Peer groups may provide a secure cooperative environment. Peer group boundaries permit member peers to access and publish protected contents. Peer groups form virtual secure regions which boundaries limit access to the peer group resources. Secure services may be provided to peers within a secured peer group. Their boundaries may or may not reflect any underlying physical network boundaries such as those imposed by routers and firewalls. The concept of a region may virtualize the notion of routers and firewalls, subdividing the network into secure regions in a self-organizing fashion without respect to actual physical network boundaries.

Peer groups may also create a monitoring environment. Peer groups may permit peers to monitor a set of peers for any special purpose (heartbeat, traffic introspection, accountability, etc.). Peer groups may also provide a controlled and self-administered environment. Peer groups may provide a self-organized structure that is self-managed and that may be locally managed.

Peer groups using the peer-to-peer platform preferably provide several capabilities including, but not limited to, the ability to, find nearby peers, find named peers anywhere on the network, find named peer groups anywhere on the network, join and resign from a peer group, establish pipes between peer group members and find and exchange shared content.

Content

Peers may be grouped into peer groups to share content. A content is published and shared among the peer members of a peer group. In one embodiment, content may be shared among group members, but not between groups. In this embodiment, no single item of content may belong to more than one group. If the same content is published in two different peer groups, two different contents may be created. In one embodiment, a content item may be published to make the item's existence known and available to group members through the use of advertisements.

An instance of content is a copy of a content. Each content copy may be replicated on different peers in the peer group. Each copy preferably has the same content identifier as well as a similar value. Replicating contents within a peer group may help any single item of content be more available. For example, if an item has two instances residing on two different peers, only one of the peers needs to be alive and respond to the content request. In one embodiment, the peer-to-peer platform protocols do not specify how or when contents are replicated. In one embodiment, whether and how to copy an item of content may be a policy decision that may be encapsulated in higher-level applications and services, for example a content management service.

A content may be any computer content (e.g. code, data, applications, active content such as services, or other collection of computer-representable resources). Examples of content include, but are not limited to, a text file, a structured document (e.g. a PDF or a XML file), a Java “.jar” or loadable library, code or even an executable process (checkpointed state). No size limitation is assumed. Each content instance may reside on a different peer in the peer group. The instances may differ in their encoding type. HTML, XML and WML are examples of encoding types. Each instance may have the same content identifier as well as a similar set of elements and attributes, and may even exist on the same peer. An encoding metadata element may be used to differentiate instances of content. Making new instances of content on different peers may help any single item of content be more available. For example, if an item has two instances residing on two different peers, only one of the peers needs to be alive and respond to the content request.

Items of content that represent a network service may be referred to as active content. These items may have additional core elements above and beyond the basic elements used for identification and advertisement. In one embodiment, active content items may be recognized by Multi-Purpose Internet Mail Extensions (MIME) content type and subtype. In one embodiment, all peer-to-peer platform active contents may have the same type. In one embodiment, the subtype of an active content may be defined by network service providers and may be used to imply the additional core elements belonging to active content documents. In one embodiment, the peer-to-peer platform may give latitude to service providers in this regard, yielding many service implementation possibilities.

In one embodiment, each item of content may have a unique canonical name. FIG. 11 illustrates an exemplary canonical content name (which may be referred to as a content identifier or content identifier) according to one embodiment. The unique identifier may include a peer group universal unique identifier (UUID) 170, and also may include another name 174 that may be computed, parsed, and maintained by peer group members. In one embodiment, the UUID may be a 128-bit field. In one embodiment, the name may be a byte array. In one embodiment, the particular name implementation within a peer group is not mandated by the peer-to-peer platform. The name may be, for example, a hash code, a URI, a URN, or a name generated by any suitable means of uniquely identifying content within a peer group. In one embodiment, a length of remainder field 172 may specify the length of the name field 174 for this content in this particular implementation.

In one embodiment, once a content item has been published to the peer-to-peer network, it may not be assumed that that the content can be later retrieved from the network. The content may be only available from peers that are not currently reachable or not currently part of the network. In one embodiment, once a content item has been published to the peer-to-peer network, it may not be assumed that the content can be deleted. Replication/republication of content by peers on the network may be unrestricted and the content may propagate to peers that are not reachable from the publishing peer.

Pipes

Pipes may provide the primary channels for communication among peers and are a mechanism for establishing communication between peers. Pipes may be used as communication channels for sending and receiving messages between services or applications over peer endpoints. Pipes may connect peers that have a direct physical link and peers that do not have a direct physical link. In the latter case, one or more intermediary peer endpoints may be used to route messages between the two pipe endpoints. A pipe instance is, logically speaking, a resource within a peer group. The actual implementation of a pipe instance is typically through a pipe service. In one embodiment, at each endpoint, software to send, or receive, as well as to manage optional associated pipe message queues is assumed, but not mandated.

In one embodiment, pipes are a mechanism for interacting with services on the peer-to-peer network. Rather than assuming a specific naming system such as DNS or a specific network addressing system such as IP, the peer-to-peer platform may abstract these concepts via several mechanisms. Pipes provide a virtual abstraction of the network service using a pipe identifier which is bound to a peer identifier via a pipe advertisement, which in turn is bound to an endpoint address via a peer advertisement and an endpoint advertisement. Pipes can thus be moved from one peer to another providing flexibility in the way a service is deployed and consumed. The location of a machine (node) on the network is abstracted via the concept of the peer which binds to an endpoint. This provides support for dynamic movement of endpoint addresses for a specific peer.

In one embodiment, pipes are implemented as a service on a peer. In one embodiment, in order for a peer to send a message to another peer's pipe, both peers must be part of the same peer group. This allows groups of peers to potentially implement different kinds of pipes, allowing for a flexible approach to communication.

In one embodiment, to connect to a pipe, a peer may send a discovery request for a pipe advertisement containing specific keywords. The peer may then receive the requested pipe advertisement. The peer may then send a pipe resolver request for a peer matching the pipe identifier and may then receive the peer advertisement, for example from a pipe service that handles the request. The peer may then send data down the pipe, for example using a URL addressing scheme.

Pipes in the peer-to-peer platform are preferably asynchronous, unidirectional, stateless and unreliable to provide the lowest overhead. Pipes are preferably unidirectional, and thus in one embodiment there are input pipes and output pipes. Asynchronous pipes may enable developers to build large-scale interconnected distributed services and applications. Pipes are preferably indiscriminate and may thus support binary code, data strings, Java technology-based objects, and/or applets, among others. The peer-to-peer platform preferably does not define how the internals of a pipe work. Any number of unicast and multicast protocols and algorithms, and combinations thereof, may be used. In one embodiment, one pipe may be chained together with each section of the chain using a different transport protocol.

The pipe endpoints may be referred to as input pipes (receiving end) and output pipes (sending end). Pipes may provide the illusion of a virtual in and out mailbox that is independent of any single peer location. Services and applications may communicate through pipes without knowing on which physical peer a pipe endpoint is bound. When a message is sent into a pipe, the message is sent to all peer endpoints currently connected (listening) to the pipe. The set of currently connected pipe endpoints (input pipes) may be obtained using the pipe binding protocol.

Unlike conventional mechanisms, peer-to-peer platform pipes may have ends that may be moved around and bound to different peers at different times, or not connected at all. In one embodiment, pipes may be virtual, in that a pipe's endpoint may be bound to one or more peer endpoints. In one embodiment, pipe endpoints may be non-localized to a physical peer, and may be dynamically bound at creation time or runtime via the pipe binding protocol. The pipe binding process may include discovering and connecting the two or more endpoints of a pipe.

Using pipes, developers may build highly available services where pipe connections may be established independently of a peer location. This dynamic binding of pipes helps to provide redundant implementation of services over a P2P network. A peer may logically “pick up” a pipe at any point in time. For example, a peer that wants to use a spell checker service man connect to a peer group's spell checker pipe that is implemented as a redundant peer group service. The peer may be serviced as long as there is at least one single instance of a spell checker service still running somewhere within the peer group. Thus, using pipes as described herein, a collection of peers together may provide a high level of fault tolerance, where a new peer at a different location may replace a crashed peer, with the new peer taking over the existing pipe to keep the communication going.

In one embodiment, enhanced pipes with additional properties such as reliability, security, and quality of service may be supported. In embodiments where the peer-to-peer platform runs on top of transports that have such properties, an implementation may optimize and utilize the transports. For example, when two peers communicate with each other and both have TCP/IP support, then an implementation may use the bidirectional capabilities of TCP/IP to create bidirectional pipes. Other data transfer methods that may be implemented by pipes as provided at the service layer to provide different quality of service include, but are not limited to: synchronous request-response (the endpoint sends a message, and receives a correlated answer), streaming (efficient control-flow data transfer) and bulk transfer (bulk reliable data transfer of binary data).

Pipes may offer several modes of communication. FIG. 12 illustrates a point-to-point pipe connection between peers 200C and 200D according to one embodiment. In one embodiment, a point-to-point pipe connects exactly two peer endpoints together, an input pipe 202A that receives messages sent from an output pipe 204A. The pipe appears as an output pipe to the sender and as an input pipe to the receiver, with traffic going in one direction only—from the sender to the receiver. In one embodiment, no reply or acknowledgement operation is supported. In one embodiment, additional information in the message payload (for example, a unique identifier) may be required to thread message sequences. The message payload may also contain a pipe advertisement that can be used to open a pipe to reply to the sender (send/response).

FIG. 12 also illustrates a propagate pipe with peer 200A as a propagation source and peers 200B and 200C with listening input pipes according to one embodiment. A propagate pipe may connect two or more peer endpoints together, from one output pipe 204B to one or more input pipes (e.g. 202B and 202C). The result is that any message sent into the output pipe is sent to all input pipes. Messages flow into the input pipes from the output pipe (propagation source). A propagate message may be sent to all listening input pipes. This process may create multiple copies of the message to be sent. On transports that provide multicast (e.g. TCP/IP), when the propagate scope maps to underlying physical subnets in a one-to-one fashion, transport multicast be may used as an implementation for propagate. Propagate may be implemented using point-to-point communication on transports that do not provide multicast such as HTTP.

Messages

In one embodiment, the peer-to-peer platform may use asynchronous messages as a basis for providing Internet-scalable peer-to-peer communication. The information transmitted using pipes may be packaged as messages. Messages define an envelope to transfer any kinds of data. A message may contain an arbitrary number of named subsections which can hold any form of data. In one embodiment, the messages may be in a markup language. In one embodiment, the markup language is XML. Each peer's messaging layer may deliver an ordered sequence of bytes from the peer to another peer. The messaging layer may send information as a sequence of bytes in one atomic message unit. In one embodiment, messages may be sent between peer endpoints. In one embodiment, an endpoint may be defined as a logical destination (e.g. embodied as a URN) on any networking transport capable of sending and receiving Datagram-style messages. Endpoints are typically mapped into physical addresses by the messaging layer at runtime.

In one embodiment, a message may be a Datagram that may include an envelope and a stack of protocol headers with bodies and an optional trailer. The envelope may include, but is not limited to, a header, a message digest, (optionally) the source endpoint, and the destination endpoint. In one embodiment, each protocol header may include, but is not limited to, a tag naming the protocol in use and a body length. Each protocol body may be a variable length amount of bytes that is protocol tag dependent. Each protocol body may include, but is not limited to, one or more credentials used to identify the sender to the receiver. Such a message format preferably supports multiple transport standards. An optional trailer may include traces and accounting information.

The messaging layer may use the transport specified by the URN to send and receive messages. In one embodiment, both reliable connection-based transports such as TCP/IP and unreliable connectionless transports like UDP/IP may be supported. Other existing message transports such as IrDA, and emerging transports like Bluetooth may also be supported using the peer endpoint addressing scheme. Peer-to-peer platform messages are preferably useable on top of asynchronous, unreliable, and unidirectional transport. The peer-to-peer platform protocols preferably use a low-level message transport layer (e.g. XML) as a basis for providing Internet-scalable peer-to-peer communication. The peer-to-peer platform preferably does not assume that the networking transport is IP-based.

The message digest in the envelope may be used to guarantee the data integrity of messages. Messages may also be encrypted and signed for confidentiality and refutability. In one embodiment, each protocol body may include one or more credentials used to identify the sender to the receiver. A credential is a key that, when presented in a message body, may be used to identify a sender and to verify that sender's right to send the message to the specified endpoint. The credential may be an opaque token that is preferably presented each time a message is sent. In one embodiment, the sending address placed in the message envelope may be crosschecked with the sender's identity in the credential. Credentials may be stored in the message body on a per-protocol <tag> basis. In one embodiment, the exact format and content of the credentials are not specified by the peer-to-peer platform. For example, a credential may be a signature that provides proof of message integrity and/or origin. As another example, a message body may be encrypted, with the credential providing further information on how to decrypt the content. In one embodiment, each credential's implementation may be specified as a plug-in configuration, which preferably allows multiple authentication configurations to coexist on the same network.

When an unreliable networking transport is used, each message may be delivered more than once to the same destination or may not arrive at the destination. Two or more messages may arrive in a different order than sent. In one embodiment, high-level communication services layered upon the core protocols may perform message re-ordering, duplicate message removal, and processing acknowledgement messages that indicate some previously sent message actually arrived at a peer. Regardless of transport, messages may be unicast (point to point) between two peers or may be propagated (like a multicast) to a peer group. Preferably, no multicast support in the underlying transport is required. In one embodiment, peers receiving a corrupted or compromised message may discard the message. Messages may be corrupted or intentionally altered in transmission on the network.

The peer-to-peer platform preferably does not mandate how messages are propagated. For example, when a peer sends out a peer discovery message, the peer discovery protocol preferably does not dictate if the message should be confined to the local area network only, or if it must be propagated to every corner of the world.

The peer-to-peer platform messages 252 are preferably defined with the envelope 250 as illustrated in FIG. 13. In one embodiment, the messages are defined in a markup language. In one embodiment, the markup language is XML. The following is an exemplary message in XML:

<?xml version=“1.0” encoding=“UTF-8”?>  <SampleMessage>    <SampleMessageVersion> version number “1.0”    </SampleMessageVersion>    <SampleMessageDest> destination peer identifier    </SampleMessageDest>    <SampleMessageSrc> source peer identifier    </SampleMessageSrc>    <SampleMessageDigest> digest </SampleMessageDigest>    <SampleMessageTagName> tag </SampleMessageTagName>    <SampleMessageTagData> body </SampleMessageTagData>      . . .    <SampleMessageTagName> tag </SampleMessageTagName>    <SampleMessageTagData> body </SampleMessageTagData>    <SampleMessageTrailer> String</ SampleMessageTrailer>  </SampleMessage>

The version number may be a string. The destination and source peer identifier may be represented as peer-to-peer platform identifiers (UUIDs). In one embodiment, the digest is either an MD5 or SHA1 hash or a digital signature. The digest may serve as a placeholder for either. A message may have as many tag parts as needed. In one embodiment, the tag name may be a string and the body may be a byte array containing a string without XML escape characters (“<”, “>”) or a base64 encoded string.

In one embodiment, the message format may support binary data and/or multi-part messages with MIME-types. The message format may allow for arbitrary message header fields, including optional header fields. The message format may allow for data verification of message content and the cryptographic signing of messages. The message format may provide an arbitrary number of named subsections that may contain any form of data of any (reasonable) size. The message format may be “email-safe” such that its contents may be extracted reliably after standard textual transformations committed my E-mail client and server software.

Services

Peers may cooperate and communicate to publish, discover and invoke network services. A service denotes a set of functions that a provider offers. In one embodiment, a peer-to-peer platform peer can offer a service by itself or in cooperation with other peers. In one embodiment, a peer may publicize a service by publishing a service advertisement for the service. Other peers may then discover this service using the peer discovery protocol (through the advertisement) and make use of it. A peer may publish as many services as it can provide.

In one embodiment, services may either be pre-installed into a peer or loaded from the network. The process of finding, downloading and installing a service from the network may include performing a search on the network for the service, retrieving the service, and then installing the service. Once a service is installed and activated, pipes may be used to communicate with the service. In one embodiment, peer-to-peer platform-enabled services may publish pipe advertisements as their main invocation mechanism. The service advertisement may specify one or more pipe advertisements that may be used by a peer to create output pipes to invoke the service. The service advertisement may also include a list of predetermined messages that may be sent by a peer to interact with the service. The service advertisement may describe all messages that a client may send or receive.

Several methods may be provided by various embodiments to publish a service. Services may be published before creating a new peer group by adding the service advertisement to the peer group advertisement. Services may also be published by adding the services in a separate peer service advertisement. The discovery service may also allow new advertisements to be added at runtime. The new advertisement will belong to a predefined peer group. Other methods of publishing services may be provided. Note that service advertisements may be placed in the peer group advertisement of any group. Since all peers belong to the global peer group, a peer may publish the service in the global peer group advertisement to make it available to any peer.

In one embodiment, services advertised in a peer group advertisement are instantiated for a peer when the peer joins the group. In one embodiment, all the services are instantiated. In another embodiment, none, one or more of the advertised services may be instantiated when the peer joins the peer group. Service advertisements in the peer group advertisement may include resolver, discovery, membership, peer information and pipe service advertisements. In one embodiment, services advertised in a peer group advertisement are loaded on the peer when the peer boots. In one embodiment, this automated loading is not mandatory but is part of the Java Binding. One embodiment may provide a mechanism to force a service in a peer group advertisement to be instantiated by a peer.

In one embodiment, when a peer boots, any services advertised in the peer advertisement are loaded. The peer advertisement corresponds to the platform advertisement. These services may include the minimal set of services to bootstrap the creation of new peers: discovery service, membership service, resolver service, peer information service and pipe service.

In one embodiment, when a peer switches from one peer group to another, the first group's services remain active. In one embodiment, a peer may call a stop method on the service application interface to stop an instance of a local service. A peer that is a member of one peer group that refers to a service may join a second peer group that also refers to the service while still a member of the first. Whether the service is instantiated once or twice may depend on the service implementation. Some service implementations may use a static instantiation that is done once. In this case, all groups share the same instance. Other service implementations are local to a peer group and are not aware of the state of any other peer groups on the same node.

In one embodiment, services may use a “time to live” indicator that defines when the service was created, and would also define the lifetime of the service. After its lifetime has expired, the stale service may be purged.

A service may be well defined and widely available so that a peer can use it directly. Other services may require special code in order to actually access the service. For example, the way to interface with the service provider may be encoded in a piece of software. In this case, it is preferable if a peer can locate an implementation that is suitable for the peer's specific runtime environment. In one embodiment, if multiple implementations of the same service are available, then peers hosted on Java runtimes can use Java programming language implementations while native peers to use native code implementations. In one embodiment, service implementations may be pre-installed into a peer node or loaded from the network. In one embodiment, once a service is installed and activated, pipes may be used to communicate with the service.

In one embodiment, each service may have a unique identifier. In one embodiment, a service may have a name that may include a canonical name string that may indicate the type and/or purpose of the service. A service may also provide optional information (e.g. a set of descriptive keywords) that further describes the service. The unique identifier, name and optional information may be stored within a service advertisement. The advertisement may also include other information needed to configure and instantiate a service.

In one embodiment, the peer-to-peer platform may recognize two levels of services, peer services and peer group services. A service that executes only on a single peer may be referred to as a peer service. A peer service is accessible only on the peer that is publishing the service. If that peer happens to fail, then service also fails. This level of service reliability may be acceptable for an embedded device, for example, providing a calendar and email client to a single user. Multiple instances of the service may be run on different peers, but each instance publishes its own advertisement. A service that is composed of a collection of cooperating instances (potentially cooperating with each other) of the service running on multiple peers in a peer group may be referred to as a peer group service. A peer group service may employ fault tolerance algorithms to provide the service at a higher level of availability than that a peer service can offer. If any one peer fails, the collective peer group service may not be affected, because the service may still be available from at least one other peer member. Peer group services may be published as part of the peer group advertisement.

In one embodiment, the peer-to-peer platform may include a set of default peer group services such as peer discovery, as well as a set of configurable services such as routing. In one embodiment, a peer-to-peer platform peer may not be required to have one or all of these services. For example, a cell phone peer may be pre-configured with enough information to contact a fixed server provided by the telecom operator. This may be enough to bootstrap the cell phone peer without requiring it to independently carry with it additional services.

In one embodiment, although the concept of a service is orthogonal to that of a peer and a peer group, a peer group formed using the peer-to-peer platform may require a minimum set of services needed to support the operation of the group. Some services may be well known and may be referred to as peer-to-peer platform core services. Embodiments of the peer-to-peer platform may define a set of core peer group services that may be used to form and support peer groups. In one embodiment, the core peer group services may provide the minimum services required to form a peer group (e.g. membership and discovery services). The peer-to-peer platform core services are preferably 100% decentralized and thus may enable pure peer-to-peer network computing. In one embodiment, it is not required that all core services be implemented by every peer group.

In one embodiment, the peer-to-peer platform may define peer group core services including, but not limited to, a discovery service, a membership service, an access service, a pipe service, a resolver service and a monitoring service. A discovery service may be used to search for peer group resources such as peers, peer groups, and pipes. The search criteria may include a resource name. Discovery and discovery services are described more fully later in this document.

In one embodiment, most peer groups will have at least a membership service. Current peer group members may use the membership service during the login process to reject or accept a new peer group membership application. The membership service may be a “null” authenticator service that imposes no real membership policy. Peers wishing to join a peer group first locate a current member, and then request to join. The application to join may be either rejected or accepted by the collective set of current members. The membership service may enforce a vote of peers or alternatively elect a designated group representative to accept or reject new membership applications.

An access service may be used to validate, distribute, and authenticate a group member's credentials. The access service may define the type of credential used in the message-based protocols used within the peer group. The access service may be used to validate requests made by one peer to another. The peer receiving the request provides the requesting peer's credentials and information about the request being made to the access service to determine if the access is permitted. In one embodiment, not all actions within the peer group need to be checked with the access service, only those actions which only some peers are permitted to use.

A pipe service may be used to establish and manage pipe connections between the different peer group members. A resolver service may be used to send query string to peers to find information about a peer, a peer group, a service or a pipe. A monitoring service is used to allow one peer to monitor other members of the same peer group.

In on embodiment, not all the above services are required to be implemented by a peer group. Each service may implement one or more of the peer-to-peer platform protocols. A service preferably implements one protocol for simplicity and modularity reasons, but some services may not implement any protocols.

Other services may be user-defined and provide application dependent services such as content searching and indexing. A user-defined service may provide additional APIs. User-defined services may be implemented that may offer the ability to mix-in centralization as a means of increasing performance. In one embodiment, the peer-to-peer platform core services may provide a reference implementation for user-defined services. Examples of user defined services may include, but are not limited to:

-   -   Efficient long-distance peer lookup and rendezvous using a peer         naming and discovery service.     -   Simple, low-cost information search and indexing using a content         sharing service.     -   Interoperability with existing centralized networking         infrastructure and security authorities in corporate, public,         private, or university networks using administration services.     -   A resolver service may be implemented to find active (running on         some peer) and inactive (not yet running) service instances.     -   An FTP service that allows file transfers among peers over pipes         using FTP.         Advertisements

In one embodiment, the peer-to-peer protocols may use advertisements to describe and publish the existence of peer resources. An advertisement may be defined as a structured, language neutral metadata structure that names, describes, and publishes the existence of a peer-to-peer platform resource, such as a peer, a peer group, a pipe, or a service.

In one embodiment, advertisements may be used in the peer-to-peer platform as language-neutral metadata structures. In one embodiment, each software platform binding may describe how advertisements are converted to and from native data structures such as Java objects or ‘C’ structures. Each protocol specification may describe one or more request and response message pairs. In one embodiment, advertisements may be the most common document exchanged in messages.

Information exchanged between peers may include advertisement documents. The peer-to-peer platform preferably includes advertisement documents to represent all of the peer-to-peer platform resources managed by the core platform, such as peers, peer groups, pipes and services. In one embodiment, the peer-to-peer platform may define a set of core advertisements. The peer-to-peer platform may define core advertisement types including, but not limited to, one or more of peer advertisements, peer group advertisements, pipe advertisements, service advertisements, content advertisements, and endpoint advertisements. In one embodiment, user-defined advertisement subtypes (for example, using XML schemas) may be formed from these basic types. Subtypes of the core advertisements may be used to add an unlimited amount of extra, richer metadata to a peer-to-peer network. The peer-to-peer platform protocols, configurations and core software services however, preferably operate only on the core advertisements.

In one embodiment, an advertisement is a markup language structured document that names, describes, and publishes the existence of a peer-to-peer platform resource. In one embodiment, peer-to-peer platform advertisements may be represented in the Extensible Markup Language (XML) and are therefore software platform neutral. XML provides a powerful means of representing data and metadata throughout a distributed system. XML provides universal (software-platform neutral) data because XML is language agnostic, self-describing, strongly-typed and ensures correct syntax. XML advertisements may be strongly typed and validated using XML schemas. XML also allows advertisements to be translated into other encodings such as HTML and WML. This feature allows peers that do not support XML to access advertised resources. In one embodiment, each document may be converted to and from a platform specific representation such as a Java object. In one embodiment, peers supporting the various protocols requiring that advertisements be exchanged in messages may accept only valid XML documents that descend from the base XML advertisement types.

Advertisements represented in a markup language such as XML, like any markup language document, may be composed of a series of hierarchically arranged elements. Each element may include its data and/or additional elements. An element may also have attributes. Attributes are name-value string pairs. An attribute may be used to store metadata, which may be used to describe the data within the element.

FIG. 37A illustrates a peer in a peer-to-peer network publishing an advertisement according to one embodiment. Peer 200A may include or may have access to resources that it may publish. Resources may include, but are not limited to, peers, peer groups, services, content, pipes and pipe endpoints. A resource advertisement may include an identifier and a security credential. The identifier and security credential may be compared to confirm that they indicate the same resource when another peer accesses the resource. In one embodiment, a public key may be associated with the advertised resource. In one embodiment, the security credential may be a public key signature.

Peer 200A may generate resource advertisement 808 which may describe how other peers may access the resource. Resource advertisements may be formatted according to platform-independent markup language schemas defining elements of each type of advertisement (e.g., XML). Peer 200A may allow other peers access to the resource by publishing advertisement 808. In one embodiment, publishing may include sending advertisements to other peers. In FIG. 29A, peer 200A may send advertisement 808 to peers 200B and 200C in messages 820A and 820B. Messages 820A and 820B may be formatted according to a peer-to-peer platform protocol. Another peer may discover advertisement 808 by sending a discovery query message that may include criteria that the resource corresponding to advertisement 808A may match to one or both of peer 200B and peer 200C, and one or both of peer 200B and peer 200C sending a response message that may contain advertisement 808 to the other peer.

FIG. 37B illustrates a peer in a peer-to-peer network publishing an advertisement to a rendezvous peer according to one embodiment. Peer 200A may publish advertisement 808A by sending it to rendezvous peer 200B in message 820. Rendezvous peer 200B may cache advertisements for other peers to discover. In one embodiment, advertisement 808A may include a time-to-live indicator (TTL). The TTL may indicate a length of time during which the resource advertisement is valid. When the TTL expires, peers may no longer have access to the resource advertisement. Another peer may discover advertisement 808A by sending a discovery query message that may include criteria that the resource corresponding to advertisement 808A may match to peer 200B, and peer 200B sending a response message that may contain advertisement 808 to the other peer.

FIG. 38 illustrates discovering advertisements according to one embodiment. Peer 200A may broadcast discovery query message 820. Discovery query message 820 may be formatted in accordance with a peer-to-peer platform discovery protocol. Discovery query message 820 may include criteria specifying a particular type of resource in which the peer is interested. When the discovery query message 820 reaches a peer 200B that has advertisements 808A and 808B for resources matching the criteria in the discovery query message, peer 200B may respond by sending peer 200A a response message 822 that may include the advertisements 808A and 808B. Peer 200A may also receive one or more response messages from one or more other peers. Each of these response messages may include advertisements for resources for resources also matching the criteria in the discovery query message. After receiving the resource advertisements, peer 200A may access the corresponding resource. In one embodiment, each resource advertisement may include information describing how to access the particular resource corresponding to the resource advertisement.

In one embodiment, a peer advertisement may be used to describe a peer. A peer advertisement may describe the peer resources. One use of a peer advertisement is to hold specific information about the peer, such as its name, peer identifier, registered services and available endpoints. FIG. 14 illustrates the content of a peer advertisement according to one embodiment. The following is an example of one embodiment of a peer advertisement in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <PeerAdvertisement> <Name> name of the peer</Name> <Keywords>search keywords </Keywords> <Pid> Peer identifier </Pid> <Services> <Service advertisement> . . . </Service advertisement> </Services> <Endpoints> <endpoint advertisement> . . . </endpoint advertisement> </Endpoint> <InitialApp> <Service advertisement> . . . </Service advertisement> </InitialApp> </PeerAdvertisement>

Embodiments of a peer advertisement may include, but are not limited to, the following fields:

-   -   Name: an optional string that can be associated with a peer. In         one embodiment, the name is not required to be unique unless the         name is obtained from a centralized naming service that         guarantees name uniqueness.     -   Keywords: an optional string that may be used to index and         search for a peer. In one embodiment, the string is not         guarantee to be unique. Two peers may have the same keywords.         The keywords string may contain spaces.     -   Peer identifier: uniquely identifies the peer. In one         embodiment, this may be a required element. Each peer has a         unique identifier.     -   Service: a service advertisement element for each service         published on the peer. Services started on a peer may publish         themselves to the peer. In one embodiment, not all services         running on the peer need to publish themselves.     -   Endpoint: an endpoint URI (e.g. Tcp://129.144.36.190:9701 or         http://129.144.36.190:9702) for each endpoint available on the         peer.     -   InitialApp: Optional application/service started when the peer         is booted. A service advertisement is used to describe the         service.

In one embodiment, a peer group advertisement may be used to describe, for a peer group, the group specific information (name, peer group identifier, etc.), the membership process, and the available peer group services. The peer group advertisement defines the core set of services to be used by that peer group. In one embodiment, it may not enforce that each peer must run each service locally. Rather it defines the set of services that are made available to the peer group.

In one embodiment, the initial creator of the peer group may define what advertisements go into the peer group advertisement at creation time. Other peers may get a copy of the peer group advertisement when they discover advertisements via the discovery service. In one embodiment, peer group advertisements are immutable objects and new services may not be added due to java binding. Other embodiments may allow new services to be added. In one embodiment, a peer group may provide a registration service that allows the dynamic registration of services.

FIG. 15 illustrates the content of a peer group advertisement according to one embodiment. The following is an example of one embodiment of a peer group advertisement in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <Peer groupAdvertisement> <Name> name of the peer group</Name> <Keywords>search keywords </Keywords> <Gid> Peer group identifier </Gid <Services> <Service advertisement> . . . </Service advertisement> </Services> </InitialApp> <Service advertisement> . . . </Service advertisement> </InitialApp> </Peer groupAdvertisement>

Embodiments of a peer group advertisement may include, but are not limited to, the following fields:

-   -   Name: an optional name that may be associated with a peer group.         In one embodiment, the name is not required to be unique unless         the name is obtained from a centralized naming service that         guarantee name uniqueness.     -   Keywords: an optional string that may be used to index and         search for a peer group. In one embodiment, the string is not         guarantee to be unique. Two peer groups may have the same         keywords.     -   Peer group Id: uniquely identifies the peer group. In one         embodiment, this is a required element. Each peer group has a         unique id.     -   Service: a service advertisement element for each peer group         service available in the peer group. In one embodiment, not all         peer group services need to be instantiated when a peer joins a         peer group. In one embodiment, at least a membership service         should be available, so the membership service may implement a         null authenticator membership.     -   InitialApp: optional application/service started when a peer is         joining a peer group. A service advertisement may be used to         describe the service. The initial application may be started         when a peer is joining a group. Alternatively, it may be left to         the joining peer to decide to either start or not start the peer         group initial application.

Once a peer joins a group, that peer may receive (depending again upon membership configuration) a full membership-level peer group advertisement. The full membership advertisement, for example, might include the configuration (required of all members) to vote for new member approval.

In one embodiment, a pipe advertisement may be used to describe an instance of a pipe communication channel. A pipe advertisement may be used by a pipe service to create associated input and output pipe endpoints. In one embodiment, a pipe advertisement document may be published and obtained using either the core discovery service or by embedding it within other advertisements such as the peer or peer group advertisement. Each pipe advertisement may include an optional symbolic name that names the pipe and a pipe type to indicate the type of the pipe (point-to-point, propagate, secure, etc). FIG. 16 illustrates the content of a pipe advertisement according to one embodiment. The following is an example of one embodiment of a pipe advertisement in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <PipeAdvertisement> <Name> name of the pipe</Name> <Id> Pipe identifier </Id> <Type> Pipe Type </Type> </PipeAdvertisement>

Embodiments of a pipe advertisement may include, but are not limited to, the following fields:

-   -   Name: an optional name that may be associated with a pipe. In         one embodiment, the name is not required to be unique unless the         name is obtained from a centralized naming service that         guarantee name uniqueness.     -   Pipe identifier: uniquely identifies the pipe. In one         embodiment, this is a required element. Each pipe has a unique         id.     -   Type: This is an optional pipe type that may be provided to         specify the quality of services implemented by the pipe. Pipe         types may include, but are not limited to:         -   RELIABLE (guaranteed delivery and ordering, and deliver only             once)         -   UNRELIABLE (may not arrive at the destination, may be             delivered more than once to the same destination, may arrive             in different order)         -   SECURE (reliable and encrypted transfer)

In one embodiment, a service advertisement may be used to describe a peer-to-peer platform-enabled service. Service advertisements preferably describe how to activate and/or use the service. In one embodiment, a peer-to-peer platform-enabled service is a service that uses pipes as primary invocation mechanism. To invoke the service, a peer may a message to the associated service pipe. In one embodiment, the core peer group services that each peer group preferably implements in order to respond to the messages described for the peer-to-peer platform protocols are peer-to-peer platform-enabled services and thus may be published using service advertisements. The service advertisement document may be published and obtained using the peer information protocol for peer services, or alternatively using the peer group discovery protocol for peer group services.

In one embodiment, a pipe advertisement and access method fields may provide a placeholder for any kind of service invocation schema that defines the valid set of XML messages accepted by the service and the associated message flow. Thus, the peer-to-peer platform protocols may be agnostic of service invocation and interoperate with any existing framework. A service advertisement access method field may refer to a WSDL (e.g. www.w3.org/TR/wsdl), ebXML (e.g. www.ebxml.org), UPnP (e.g. www.upnp.org) or a client-proxy schema, among others. For example, a WSDL access method may define messages that are abstract descriptions of the data being exchanged and the collections of operations supported by the service using a WSDL schema. In one embodiment, a service advertisement may include multiple access method tags, as there may be multiple ways to invoke a service. Thus, the peer may ultimately decide which invocation mechanism to use. For example, small devices may want to use a small-footprint mechanism or a service framework they already have the code for, and larger devices may decide to download a client-proxy code.

In one embodiment, the access method for services is a schema of valid XML messages accepted by the service. In one embodiment, a service advertisement may contain a URL or URI tag to point to a jar file, DLL, or loadable library. A peer may use this to download the code to run the service, for example if the peer joins the peer group and doesn't have the required code to run the service.

FIG. 39 illustrates cross-platform activation of a service according to one embodiment. Peer 200A may be implemented on a computing platform A. Peer 200A may have discovered an advertisement for service 504 that includes platform-independent activation instructions for a service 504 implemented on a computing platform B, different from computing platform A. Peer 200A may carry out the instructions to activate service 504 even though their computing platforms, A and B, are different. For example, peer implemented on a Macintosh OSX computing platform may activate a search engine for used cars implemented on an Intel Windows computing platform.

FIG. 40 is a flowchart illustrating a method of cross-platform activation of a service according to one embodiment. A peer implemented on a computing platform may discover an advertisement including platform-independent activation instructions for a service implemented on a different computing platform as indicated at 908. The activation instructions may include a pipe advertisement and platform-independent messages for activating the service. The peer may activate the service by sending one or more of the messages via the pipe as indicated at 912.

In one embodiment, once a service advertisement is sent out into the world there is no method of pulling it back in. However, each individual peer may have the ability to purge the set of cached advertisements that reside locally, and a rendezvous peer may purge its cache periodically (e.g. daily).

FIG. 41 is a flowchart illustrating a method of creating a service advertisement according to one embodiment. A peer may instantiate a service as indicated at 902. The peer may generate a service advertisement to allow access to the service to other peers in a peer-to-peer network. In one embodiment, the service advertisement may include a pipe advertisement for a pipe to communicate with the service and activation instructions to allow the other peers access to the service. The service advertisement may also include a time-to-live indicator (TTL). The TTL may indicate a length of time during which the service advertisement is valid. When the TTL expires, peers may no longer have access to the service advertisement. The service advertisement may also include an identifier and a security credential. The identifier and security credential may be compared to confirm the identity of the service. In one embodiment, a public key may be associated with the service advertised, and the security credential may be a public key signature.

The peer may publish the service advertisement as indicated at 906. For example, the peer may send the service advertisement to a rendezvous peer, and/or the peer may broadcast the service advertisement to one or more other peers. Peers on the network may then discover the published advertisement on the peer or on a rendezvous peer by sending a discovery query message including criteria that the service corresponding to the service advertisement matches. Upon receiving the discovery query message, a peer may send a response message including the service advertisement to the requesting peer.

FIG. 42 is a flowchart illustrating a method of discovering resource advertisements according to one embodiment. To discover a resource, a peer may broadcast a discovery query message on a peer-to-peer network as indicated at 910. The discovery query message may include criteria specifying the particular type of resources in which the peer is interested. Another peer that has one or more advertisements of resources matching the criteria may receive the discovery query message as indicated at 912. The peer may send one or more response message including the advertisements for resources matching the criteria to the requesting peer as indicated at 914. The requesting peer may receive the response message as indicated at 916. Each of the one or more resource advertisements included in the one or more response messages may include an identifier and a security credential for the resource associated with the advertisement. The requesting peer may compare the identifier and security credential to confirm the identity of the resource. In one embodiment, a public key may be associated with the resource advertised, and the security credential may be a public key signature. The requesting peer may use the information included in the one or more resource advertisements to access one or more resources associated with the advertisements as indicated at 918.

FIG. 43 illustrates a method of discovering implementations of a service according to one embodiment. A peer may broadcast a discovery query message to other peers on a peer-to-peer network as indicated at 920. In response, the peer may receive one or more service advertisements from other peers on the network. One or more of these responses may be a service class advertisement as indicated at 922. The service class advertisement may include one or more advertisements for implementations of a service on one or more peers on the network. An advertisement may include information that describes how to access the particular service implementation. The peer may access a desired service implementation using the information from the advertisement corresponding to the service implementation as indicated at 924. Services may be implemented on a variety of computing platforms. These service implementations may include, but may not be limited to, a Java implementation and a native code implementation.

FIG. 17 illustrates the content of a service advertisement according to one embodiment. The following is an example of one embodiment of a service advertisement in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <ServiceAdvertisement> <Name> name of the Service</Name> <Version> Version identifier </Version> <Keywords>search keywords </Keywords> <Id> Service identifier </Id> <Pipe> Pipe endpoint to access the service </Pipe> <Params> service configuration parameters </Params> <URI> service provider location</URI> <Provider> Service Provider</Provider> <AccessMethods> . . . </AcessMethods> </ServiceAdvertisement>

Embodiments of a service advertisement may include, but are not limited to, the following fields:

-   -   Name: an optional name that may be associated with a service. In         one embodiment, the name is not required to be unique unless the         name is obtained from a centralized naming service that         guarantees name uniqueness.     -   Keywords: an optional string that may be used to index and         search for a service. In one embodiment, the string is not         guaranteed to be unique. Two services may have the same         keywords.     -   Service Id: uniquely identifies a service. In one embodiment,         each service has a unique id. In one embodiment, this element         may be required.     -   Version: specifies the service version number. In one         embodiment, this element may be required.     -   Provider: gives information about the provider of the service.         This will typically be a vendor name. In one embodiment, this         element may be required.     -   Pipe: an optional element that specifies a pipe advertisement to         be used to create an output pipe to connect to the service. In         one embodiment, services are not required to use pipes.     -   Params: a list of configuration parameters available to the peer         when invoking the service. In one embodiment, the parameter         field is optional. Parameters may be defined as a list of         strings.     -   URI: This is an optional parameter that may be used to specify         the location of where the code for the service may be found.     -   Access Methods: In one embodiment, at least one access method is         required to specify how to invoke the service. Multiple access         method tags may be used when multiple access methods are         available. The access method tag allows any kind of service         invocation representation to be specified. For example the         access method may be a placeholder for a WSDL or uPnP document         that describes a web service access method.

In one embodiment, a content advertisement may be used to describe a content document stored somewhere in a peer group. In one embodiment, there are no restrictions on the type of contents that can be represented. A content may be a file, a byte array, code or process state, for example. In one embodiment, each item of content may have a unique identifier also known as its canonical name. The unique identifier may include a peer group universal unique identifier (UUID), and also may include another name that may be computed, parsed, and maintained by peer group members. In one embodiment, the content's name implementation within the peer group is not mandated by the peer-to-peer platform. The name may be a hash code, a URI, or a name generated by any suitable means of uniquely identifying content within a peer group. The entire canonical content name may be referred to as a content identifier or content identifier. FIG. 11 illustrates an exemplary content identifier according to one embodiment.

FIG. 18 illustrates a content advertisement according to one embodiment. A size element is preferably provided for all content items and gives the total size of the content. In one embodiment, the size is in bytes. In one embodiment, the size is a long (unsigned 64-bits). A content advertisement may also include a MIME (Multi-Purpose Internet Mail Extensions) type that describes the MIME type (encoding may be deduced from the type) of the in-line or referenced data. A content advertisement may also include a RefID element. If the advertised content is another advertisement (based upon its type), the RefID is the content identifier of the referenced content. If the advertised content is not another advertisement, the RefID element may be omitted.

The following is an example of one embodiment of a content advertisement in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF.8”?> <ContentAdvertisement> <Mimetype> name of the pipe</Mimetype> <Size> Pipe identifier </Size> <Encoding> Pipe Type </Encoding> <identifier> Content identifier</identifier> <RefID> Content identifier </RefID> <Document> document </Document> </ContentAdvertisement>

Embodiments of a content advertisement may include, but are not limited to, the following fields:

-   -   identifier: in one embodiment, all contents have a unique id.     -   Size: the total size of the content. In one embodiment, a long         (unsigned 64-bits) represented as a string. “−1” indicates that         the size is unknown.     -   Mimetype: the mime type of the content. The type may be unknown.     -   Encoding: specifies the encoding used.     -   RefID: if the advertised content is about another content, the         RefID specifies the content identifier of the referenced         content.

In one embodiment, an endpoint advertisement may be used to describe peer transport protocols. In one embodiment, a peer may support one or more transport protocols. In one embodiment, peers may have multiple network interfaces. Typically, there will be one peer endpoint for each configured network interface and/or protocol (e.g. TCP/IP, HTTP). An endpoint advertisement may be included as a tag field in a peer advertisement to describe the endpoints available on the member peer. In one embodiment, an endpoint advertisement document may be published and obtained using either the core discovery service or by embedding it within other advertisements such as the peer advertisement. Each endpoint advertisement may include transport binding information about each network interface or transport protocol. Endpoints may be represented with a virtual endpoint address that may include all necessary information to create a physical communication channel on the specific endpoint transport. For example, “tcp://123.124.20.20:1002” or “http://134.125.23.10:6002” are string representing endpoint addresses. FIG. 19 illustrates the content of an endpoint advertisement according to one embodiment. The following is an example of one embodiment of an endpoint advertisement in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <EndpointAdvertisement> <Name> name of the endpoint</Name> <Keywords> serach string </Keywords> <Address> endpoint logical address </Address> </EndpointAdvertisement>

Embodiments of an endpoint advertisement may include, but are not limited to, the following fields:

-   -   Name: an optional name that may be associated with an endpoint.         In one embodiment, the name is not required to be unique unless         the name is obtained from a centralized naming service that         guarantee name uniqueness.     -   Keywords: an optional string that may be used to index and         search for an endpoint. In one embodiment, the string is not         guarantee to be unique. Two endpoints may have the same         keywords.         Peer-to-Peer Platform Protocols

The peer-to-peer platform protocols may be used to provide and support ad hoc, pervasive, and multi-hop peer-to-peer (P2P) network computing. Using the protocols, peers can cooperate to form self-organized and self-configured peer groups independently of their positions in the network (e.g. edges, firewalls), and without the need of a centralized management infrastructure. The peer-to-peer platform protocols may have very low overhead, make few assumptions about the underlying network transport and limited requirements of the peer environment, and may be used to deploy a wide variety of P2P applications and services in a highly unreliable and changing network environment.

In one embodiment, the peer-to-peer platform may include core protocols including, but not limited to, a peer membership protocol, a peer discovery protocol, a peer resolver protocol, a peer information protocol, a pipe binding protocol, and a peer endpoint protocol. These protocols may be implemented using a common messaging layer. This messaging layer binds the protocols to various network transports. In one embodiment, the peer-to-peer platform protocols may be specified as a set of markup language (e.g. XML) messages exchanged between peers. Each software platform binding describes how a message is converted to and from a native data structures such as a Java object or ‘C’ structure. In one embodiment, the use of markup language messages to define protocols allows many different kinds of peers to participate in a protocol. Each peer is free to implement the protocol in a manner best suited to its abilities and role. Peer-to-peer platform messages are described previously in this document.

In one embodiment, each of the protocols is independent of the others. Preferably, a peer is not required to implement all of the networking protocols. A peer preferably needs to implement only the protocol that it requires. For example, a device may have all the advertisements it uses pre-stored in memory, so that peer does not need to implement to the Peer Discovery Protocol. As another example, a peer may use a pre-configured set of peer routers to route all its messages, hence the peer does not need to implement the Peer Endpoint protocol. Instead, the peer sends messages to the routers to be forwarded. As yet another example, a peer may not need to obtain or wish to provide status information to other peers, hence the peer does not to implement the peer information protocol. The same can be said about all of the other protocols. In one embodiment, a peer may implement only a portion (client-side or server-side only, for example) of a protocol.

Peers may use the peer-to-peer platform protocols to advertise their resources and to discover network resources (services, pipes, etc.) available from other peers. Peers may form and join peer groups to create special relationships. The peer-to-peer platform protocols may allow peers to communicate without needing to understand or manage the potentially complex and dynamic network topologies that are becoming common. Peers may cooperate to route messages allowing for full peer connectivity. The peer-to-peer platform protocols allow peers to dynamically route messages across multiple network hops to any destination in the network (potentially traversing firewalls). Each message may include either a complete or a partial ordered list of gateway peers through which the message might be routed. If route information is incorrect, an intermediate peer may assist in dynamically finding a new route. A peer-to-peer platform protocol message that is routed through multiple hops is preferably not assumed to be reliably delivered, even if only reliable transports such as TCP/IP are used through all hops. A congested peer may drop messages at any time rather than routing them.

The peer-to-peer platform protocols may be implemented on a variety of networks including, but not limited to, the Internet, corporate intranets, dynamic proximity networks, home networking environments, LANs and WANs. The peer-to-peer platform protocols may allow the peer-to-peer platform to be easily implemented on unidirectional links and asymmetric transports. In particular, many forms of wireless networking do not provide equal capability for devices to send and receive. The peer-to-peer platform permits any unidirectional link to be used when necessary, improving overall performance and network connectivity in the system. Thus, the peer-to-peer platform protocols may be easy to implement on any transport. Implementations on reliable and bidirectional transports such as TCP/IP or HTTP may provide efficient bidirectional communications. Even on bidirectional transports, communication ability between any pair of peers may at times not work equally well in both directions. That is, communications between two peers will in many cases be able to operate bidirectionally, but at times the connection between two peers may be only unidirectional, allowing one peer to successfully send messages to the other while no communication is possible in the reverse direction. The peer-to-peer platform unidirectional and asymmetric transport also plays well in multi-hop network environments where the message latency may be difficult to predict. Furthermore, peers in a P2P network tend to have nondeterministic behaviors and thus may appear or leave the network very frequently.

In one embodiment, the peer-to-peer platform protocols do not require a broadcast or multicast capability of the underlying network transport. Messages intended for receipt by multiple peers (propagation) may be implemented using point-to-point communications. The peer-to-peer platform protocols preferably do not require periodic messages of any kind at any level to be sent within the network, and thus preferably do not require periodic polling, link status sensing, or neighbor detection messages, and may not rely on these functions from any underlying network transport in the network. This entirely on-demand behavior of the protocols and lack of periodic activity may allow the number of overhead messages generated by the peer-to-peer platform to scale all the way down to near or at zero, when all peers are stationary with respect to each other and all routes needed for current communication have already been discovered.

In one embodiment, the peer-to-peer platform protocols are defined as idempotent protocol exchanges. The same messages may be sent/received more than once during the course of a protocol exchange. Preferably, no protocol states are required to be maintained at both ends. Due to the unpredictability of P2P networks, assumptions may not be made about the time required for a message to reach a destination peer, and thus the peer-to-peer platform protocols preferably do not impose any timing requirements for message receipt.

The peer-to-peer platform protocols may take advantage of additional optimizations, such as the easy ability to reverse a source route to obtain a route back to the origin of the original route.

FIG. 20 illustrates protocols and bindings in a peer-to-peer platform according to one embodiment. When the peer-to-peer platform protocols are implemented using a particular programming language and over a particular transport protocol, the implementation is an instance of a peer-to-peer platform binding 220, where the peer-to-peer platform protocols are bound to the language and the transport layer. In one embodiment, protocol and peer software implementation issues may be defined in documents specific to the binding. A binding document describes how the protocols are bound to an underlying network transport (such as TCP/IP or UDP/IP) or to a software platform such as Java 222 or a native software platform 224 such as UNIX.

The following describes the transport binding of the peer-to-peer platform protocols over TCP/IP including the message wire format of peer-to-peer platform endpoint messages over a TCP/IP socket connection according to one embodiment. Each TCP/IP message may include a header and a body. In one embodiment, the format of the header is: Type Source IP address Source Port Size Option Unused

The type may include information used to either unicast or multicast the request. The type may indicate whether this is a propagate message, a unicast message, an ACK or a NACK. The port may allow each peer to decide to bind its transport service to a specific port number. The TCP binding preferably does not require that a specific port be used. The size may indicate the body size (not including the header). The option may be used to specify the kind of socket connections (uni- or bi-directional) in use. The TCP/IP binding does not require the maintenance of any states. The normal operation is for one peer to send a TCP/IP packet to another one, and to close the socket after the packet is sent. This is the minimum functionality required to implement unidirectional pipes. In one embodiment, if the receiving end decides to keep the connection active (socket “keep alive”), it may return an indicator to the sender to tell the sending end that it is keeping the connection alive. The sending end may reuse the same socket to send a new packet.

The following describes the transport binding of the peer-to-peer platform protocols over HTTP including the wire message format for the HTTP binding of the peer-to-peer platform protocols. An HTTP request format message may include a header and a body using an HTML format. For example:

<HTML> <Code> Header </Code> <Msg> Body </Msg> </HTML>

The header allows the receiving end to determine which message type is received. Message types may include request succeeded, request failed, empty (no body) and response (the body is not empty and contains data). The body may be represented as a string in the HTML request document. Connection states that may be used include, but are not limited to:

-   -   Peer Connection: Before a message can be sent to a HTTP server         peer, the HTTP client may be required to send a request for         connection to the other peer. The request for connection message         may use the empty header type. The message may be sent using a         GET request to the following server URL:         http://ip-name:port/reg/client-peerid/. Ip-name specifies the IP         of the server peer and the port is the corresponding server port         number (8080 for example). The server replies with an empty         message containing either a request succeeded or request failed         header type. The peer connection message may be used to create a         client session on the receiving peer. The receiving peer may         decide to reject the connection and refuse the client         connection. This corresponds to a client registration.     -   Message Sending: To send a message to another peer server, the         client sends a message of the response type with a message body         part. The server replies with an ok or failed message. The         message is sent to the following URL using the PUT method:         http://ip-name:port/snd/. The server replies with a message         including a request succeeded or request failed header type.     -   Message Retrieving: To retrieve messages from a peer server, the         client may send a GET request message with the empty header tag         to the following URL: http://ipname:port/rec/client-peerid/. The         server replies with may respond with a message failed message or         with a Content message including the messages retrieved.         Peer Discovery Protocol

In one embodiment, the peer-to-peer platform may include a peer discovery protocol that may allow a peer to find advertisements on other peers. The peer discovery protocol may be used to discover any published peer resources including other peers, peer groups, pipes, services and any other resource that has an advertisement in the peer-to-peer network. This protocol may be used to find members of any kind of peer group, presumably to request membership. In one embodiment, the peer discovery protocol is the default discovery protocol for all peer groups, including the world peer group. The discovery protocol may be used as a default discovery protocol that allows all peer-to-peer platform peers to understand each other at a very basic level.

The peer discovery protocol may provide, at the lowest level, the minimum building blocks for propagating discovery requests between peers. Thus, the peer discovery protocol may provide the essential discovery infrastructure for building high-level discovery services. In many situations, discovery information is better known by a high-level service, because the service may have a better knowledge of the topology (firewall traversal), and the connectivity between peers. The peer discovery protocol may provide a basic mechanism to discover advertisements while providing hooks so high-level services and applications can participate in the discovery process. Services may be able to give hints to improve discovery (i.e. decide which advertisements are the most valuable to cache).

In one embodiment, the peer discovery protocol may be based on web crawling and the use of rendezvous peers. Rendezvous peers are peers that offer to cache advertisements to help others peers discover resources, and propagate requests they cannot answer to other known rendezvous peers. Rendezvous peers and their use in the discovery process are discussed later in this document.

In one embodiment, custom discovery services may choose to leverage the peer discovery protocol. If a peer group does not have its own discovery service, the peer discovery protocol is preferably used as the method for probing peers for advertisements. Rendezvous peers may keep a list of known peers and peer groups. This list may or may not be exhaustive or timely. A custom discovery service (if it knew that the region's rendezvous did keep a timely exhaustive list), for example, may discover all peers in the region by sending a single message to the rendezvous peer.

In one embodiment, peer discovery may be done with, or alternatively without, specifying a name for the peer to be located and/or the group to which peers belong. When no name is specified, all discovered advertisements of the requested type may be returned. If a probing peer provides the name of the peer to be located, a simple translation may be requested that returns that peer's advertisement. Once a peer is discovered, ping, status, and capability messages may be sent to its “main” endpoint(s) using a peer information protocol. Peers may export more than one endpoint. Preferably, each peer designates at least one primary endpoint to handle the low-level housekeeping protocols such as the peer discovery protocol and the peer information protocol.

In one embodiment, the peer discovery protocol may be used to probe network peer groups looking for peers that belong to specified peer groups. This process may be referred to as screening. Peers may be screened for membership by presenting each candidate member with a peer group name (string matched with the peer group advertisement canonical name). Preferably, peers claiming to belong to this group may respond, while other peers do not respond. The peer discovery protocol may be used to discover any type of core advertisement including, but not limited to: peer advertisements, peer group advertisements, pipe advertisements and service advertisements.

Peer groups need customizable and adaptable discovery policies. In one embodiment, the peer-to-peer platform may be policy-agnostic, and may only provide the basics for discovery. The basics may include one or more core discovery protocols including, but not limited to, a propagate protocol (broadcast within a scope range (subnet or peer group members)), a rendezvous protocol (unicast to a trusted discovery peer) and an invite protocol (reverse discovering).

A discovery policy may be implemented in a discovery service based on the core discovery protocol. In one embodiment, a discovery service in the core peer-to-peer platform may be used to discover abstractions and/or entities in the peer-to-peer network including, but not limited to, peers, peer groups, peer group policies (group defined services) and pipe endpoints.

In some embodiments of a peer-to-peer platform, the discovery service may rely on trusted peers (discovery proxies). The discovery service may leverage local neighbors (local propagate). The discovery service may use rendezvous peers (indexes). The discovery service may leave traces in discovery proxies (cache). The discovery service, may use net crawling as a last resort (propagate between trusted discovery proxies). In one embodiment, a discovery service may not discover some entities in the peer-to-peer network including, but not limited to, content (large scale; in one embodiment, a content management service may be used for content discovery), metadata (maintain relationship between data), users, and applications.

Embodiments of a peer-to-peer platform discovery service may leverage surrounding peers and peer groups, provide meetings points for far away peers and groups, use an asynchronous protocol and provide reverse discovery. The discovery service preferably may be used to find new neighbor peers and provide the ability for a peer to learn about other peer's abilities. Embodiments of a discovery service in the peer-to-peer platform may provide extensibility, spontaneous configuration, adaptive connectivity, a dynamic (i.e. no fixed) network topology, and the ability to reach the “edge of the Internet” (firewall, and NAT).

Embodiments of a discovery method in the peer-to-peer platform preferably do not require centralized naming (e.g. no DNS). A discovery service preferably may provide predefined meeting points that may be used in platform bootstrapping. The discovery service preferably may support a dynamic environment (peers may come and go). The discovery service preferably may support an unreliable environment (peers may fail). The discovery service preferably may help to adapt to a changing environment through viral behavior. The discovery service preferably may be used to improve performance as a system ages (increase locality). The discovery service preferably may be used in support of security (change of physical location). The discovery service preferably may be used that provides administrationless discovery (zero-admin).

Embodiments of the peer-to-peer platform discovery service may allow a peer to learn about other peers that discover it. In one embodiment, the peer-to-peer platform discovery service may provide application-managed rendezvous. In one embodiment of the peer-to-peer platform, a peer discovery protocol may support a discovery query message and a discovery response message to be used in the peer discovery process.

Peer groups need customizable and adaptable discovery policies. One approach to implementing a discovery policy is to start simple and build more complex policies. Embodiments of the peer-to-peer platform discovery service may support discovery methods including, but not limited to:

-   -   Propagate Discovery         -   Unicast to predefined rendezvous         -   Leverage transport dependent multicast (e.g. IP)     -   Unicast Discovery         -   Unicast to known rendezvous for forward propagation         -   May be used for reverse Discovery

The peer-to-peer platform preferably does not mandate exactly how discovery is done. Discovery may be completely decentralized, completely centralized, or a hybrid of the two. Embodiments of the peer-to-peer platform may support discovery mechanisms including, but not limited to:

-   -   LAN-based discovery. This is done via a local broadcast over the         subset.     -   Discovery through invitation. If a peer receives an invitation         (either in-band or out-of-band), the peer information contained         in the invitation may be used to discover a (perhaps remote)         peer.     -   Cascaded discovery. If a peer discovers a second peer, the first         peer may, with the permission of the second peer, view the         horizon of the second peer to discover new peers, groups, and         services.     -   Discovery via rendezvous points. A rendezvous point is a special         peer that keeps information about the peers it knows about. A         peer that can communicate via a rendezvous peer, for example via         a peer-to-peer protocol pipe, may learn of the existence of         other peers. Rendezvous points may be helpful to an isolated         peer by quickly seeding it with lots of information. In one         embodiment, a web site or its equivalent may provide information         of well-known peer-to-peer protocol rendezvous points.

In one embodiment, a peer-to-peer platform web of trust may be used. In a web of trust, a peer group creator may select initial discovery proxies, and may delegate to new peer members. Any peer, when trusted, can become a discovery proxy. Discovery proxies may propagate requests between each other for net-crawling discovery. New peers may be untrusted or low-trust peers, and may be typically difficult to find and have limited discovery range (this may help protect against misbehaviors and denial of service attacks). Trusted members are easier to discover. Peers may increase their discovery range as they become more trusted (discovery credential). Some peers may not need to discover beyond their initial net peer group range.

In one embodiment, a peer may go through a proximity network, which also may be referred to as a subnet or region, to try to find (discover) surrounding peers. The Internet includes the concept of subnets that are physically defined by physical routers that define regions in which computer systems are connected to one another. Within one of these regions, the peer-to-peer protocol uses multicast or other propagate mechanism to find peers. In one embodiment, a propagate discovery mechanism may be provided where one peer can propagate a discovery request through a local subnet. Peers that are in the subnet may respond to the discovery request. The propagate discovery mechanism may provide primarily close range discovery. In one embodiment, only peers that are in the same physical subnet (region) may respond. “Propagate” is at the conceptual level. Multicast is implemented by TCP/IP to provide propagate capabilities. Other transports may use other methods to implement propagate. For example, Bluetooth provides a different implementation of propagate which is not multicast.

The core discovery protocol may provide a format for a local peer to send a propagate message (a request to find information about other peers or peer groups in its local region or subnet) and also a format for a response message. A propagate may ask who's there (what peers are in the subnet). One or more peers may decide to respond. Other peers on the subnet may choose not to respond if they don't want to be discovered by the requesting peer. The response message may indicate that a peer is there and that the requesting peer may communicate with it if it wants more information. In one embodiment, the core peer-to-peer platform may define the format of the discovery requests and responses as part of the peer discovery protocol. In one embodiment, the messages may be XML messages.

One embodiment of a peer-to-peer platform may provide a bootstrapping process for peers. In one embodiment, a new peer may not know any peers or peer groups when bootstrapped. When bootstrapping, the peer may issue a peer discovery propagate message. The new peer is looking for one or more peers in the subnet. The new peer needs to reach some level of connectivity in order to support higher-level operations. From discovered peers, the new peer may acquire information needed to allow the new peer to go further in its bootstrapping process. For example, the new peer may send messages to another peer requesting information on services that the other peer may be aware of that the new peer needs for bootstrapping.

When the new peer discovers another peer or peers, it may attempt to discover peer groups. This process may be similar to the peer discovery process described above. The new peer may send (e.g. propagate) another discovery message that is configured to discover peer groups. Peers in the proximity network (region) that are aware of a peer group or peer groups may respond to the peer group discovery message, and may return information on the peer group(s) (e.g. peer group advertisements) of which they are aware. The new peer may use this information to determine a peer group or peer groups that it may be interested in joining.

In one embodiment, a peer group may be configured so that only a subset of peers within a group may have the capabilities to respond to peer group discovery messages and to provide information about the peer group to inquiring peers.

Peer and peer group discovery may both be implemented by the peer discovery protocol. Peer and peer group discover are more or less at the same level in the P2P platform. In one embodiment, peer discovery may use a message that indicates the discovery is looking for peers, and peer group discovery may use a similar message that indicates the discovery is looking for peer groups.

In one embodiment, the peer discovery protocol may be required to be implemented in a peer platform, and thus all peers will have the service running. When one peer sends (e.g. propagates) a request, then a receiving peer must send a response, unless it is configured to not respond to at least some requests from at least some peers based upon configuration parameters. In another embodiment, peers may be implemented without the peer discovery protocol. In other words, in this embodiment, peers are not required to implement the peer discovery platform. For example, on some smart devices, peer information and/or peer group information may be preconfigured into the device, and so bootstrapping may be performed on these devices without having to initiate a peer discovery.

Embodiments of the peer-to-peer platform may implement a discovery mechanism that is more suited for long-range discovery than the propagate method described above. In one embodiment, rendezvous peers may be used in discovery. A rendezvous peer may be described as a meeting point where peers and/or peer groups may register to be discovered, and may also discover other peers and/or peer groups, and retrieve information on discovered peers and/or peer groups. In one embodiment, a peer (any peer) in a peer group may decide to become or may be appointed or elected as a rendezvous peer in the group. The rendezvous peer may be advertised as a meeting point, and may be predefined on peers so that, for example, the peers, when starting up, may know to go to the rendezvous peer to find information about the peer-to-peer network. Rendezvous peers may act as information brokers or centralized discovery points so that peers can find information in an easy and efficient manner. As a peer group grows, a peer may become a rendezvous peer in the group. In one embodiment, a network of rendezvous peers may be constructed that may help to provide long-range discovery capabilities. A rendezvous peer may be aware of at least some of the other rendezvous peers in the network, and a discovery message from a peer may be forwarded from a first rendezvous peer to a second, and so on, to discover peers and/or peer groups that are “distant” on the network from the requesting peer.

Rendezvous peers may offer to cache advertisements to help others peers discover resources, and may propagate (forward) requests they cannot answer to other known rendezvous peers. Preferably, a rendezvous peer implements at least one of these two functions. The services provided by a rendezvous peer may be different than message routing. Message routing is performed at a lower level involving multi-hops connections to send a message between any peers in the network. In one embodiment, the forwarding of a request between two rendezvous peers may involve routing to propagate a request between two rendezvous, but this is transparent to the rendezvous service and done underneath.

In one embodiment, rendezvous peers may forward requests between each other. A rendezvous may be typically connected to a few other rendezvous peers. There may be as many rendezvous peers as peers in a peer group. Not every peer may be a rendezvous (e.g. if a peer has no caching capabilities or is isolated behind a firewall). In one embodiment, only rendezvous peers may forward a discovery request to another rendezvous peer. This restriction may serve to limit and control the exponential growth of request propagations within the network. Rendezvous peers may thus provide a simple throttle mechanism to control the propagation of requests. In one embodiment, sophisticated rendezvous peers may be deployed to filter and distribute requests for the best usage of network resources.

In one embodiment, a peer may be pre-configured with a pre-defined set of rendezvous peers. These bootstrapping rendezvous may help the peer discover enough network resources (peers, rendezvous, services) as it needs to support itself. In one embodiment, the pre-configured rendezvous are optional. A peer may be able to bootstrap itself by finding rendezvous or enough network resources in its proximity environment. If a peer does not know the information, it may ask the surrounding peers (hop of 1) if they know the answer. One or more peers may already have the answer. If no surrounding peers know the answer, the peer may ask its rendezvous peers to find advertisements. Peers are recognized as rendezvous peers in their peer advertisements. When a peer discovers a new peer, it can determine if this peer is a rendezvous. A peer may not be required to use all the rendezvous peers that it has discovered.

Rendezvous peers may forward requests between themselves. The discovery process continues until one rendezvous peer has the answer or the request dies. There is typically a Time To Live (TTL) associated with the request, so it is not infinitely propagated. As an example, suppose a peer A is attempting to discover a resource R on the network. Peer A issues a discovery request specifying the type (peer, peer group, pipe, service) of advertisements it is looking for. To initiate the Discovery, peer A sends a discovery request message as a single propagate packet to all its available endpoints. The packet may contain the requested peer advertisement, so the receiving peer can respond to the requester. Each discovery request identifies the initiator, and a unique request identification specified by the initiator of the request. When another peer receives the discovery request (assume peer B in this example), if it has the requested R advertisement, it will return to peer A the advertisement for R in a discovery response message. If Peer A does not get response from its surrounding peers (hop of 1), Peer A may send the request to its known rendezvous peers. If the rendezvous peers do not have the advertisement, they can propagate the request to all other rendezvous peers they know. When a rendezvous receives a respond to a request, the rendezvous may cache the R advertisement for future usage, before sending it to the requestor.

In one embodiment, the peer rendezvous capabilities may be embedded in the core discovery protocol of the peer-to-peer platform. Rendezvous peers may be protocol-based, and may broker more information than name servers that typically only broker names of entities. In one embodiment, a rendezvous peer may maintain indexes for entities in the peer-to-peer platform including peers, peer groups, and advertisements. Indexes may be dynamic indexes which may grow as the peer group community grows and more peers join. As a group joins, some peers may decide to become rendezvous peers to help peers connect with other peers in the group.

The rendezvous peer is at the peer level. A rendezvous peer is not a “service”. A rendezvous peer may be used as part of an infrastructure to construct services such as a DNS or other centralizing and index services. In one embodiment, services may interact with a rendezvous peer to obtain and/or manipulate information stored on the rendezvous peer to perform some task to make the system act more efficiently.

In a network of peers, some peers may elect themselves, through the discovery protocol, to become rendezvous peers. A rendezvous peer may act as a broker or discovery message router to route discovery messages to the right place. In other words, a rendezvous may act to route discovery requests to the right rendezvous peers. For example, a rendezvous peer may receive a message requesting information about peers that are interested in baseball. The rendezvous peer may know of another rendezvous peer that specializes in information about baseball. The first rendezvous peer may forward or route the message to the second rendezvous peer. In one embodiment, rendezvous peers may maintain connections to other rendezvous peers in order to provide discovery and routing functionality.

Rendezvous peers may support long-range discovery. For example, a first peer is at a remote location from a second peer. For one of these peers to find the other with a mechanism such as web crawling may be time consuming, since there maybe a lot of “hops” between the two peers. Rendezvous peers may provide a shortcut for one of the peers to discover the other. The rendezvous peer, thus, may serve to make the discovery process, in particular long-range discover, more efficient.

A peer-to-peer network may be dynamic. Peers and peer groups can come and go. Dynamic identifiers (addresses) may be used. Thus, routes between peers need to be dynamic. Rendezvous peers may provide a method for route discovery between peers that allows routing in the peer-to-peer network to be dynamic. In this method, the rendezvous peers may perform route discovery for peers when the peers send discovery messages to the rendezvous peers or when a peer is attempting to connect to another peer or peer group that is not in the local region of the peer. This method may be transparent to the requesting peer.

In one embodiment, the rendezvous peers may be able to cache advertisements. An advertisement may be defined as metadata or descriptions of a resource. An advertisement may include information necessary for an entity to connect to or use the resource, for example a service advertisement may include information for connecting to and using the service. Advertisements may be published to allow other entities to discover them. The rendezvous peer may provide the ability for services and applications to store and cache temporary, e.g. via a lease mechanism, advertisements. This may used, for example, when one service needs to connect to another service, and needs the pipe endpoint or communication channel that may be used to connect to the service. The pipe endpoint may be included in a service advertisement published on a rendezvous peer. Thus, in one embodiment, the rendezvous peer provides the ability for peers, peer groups, services and applications to advertise pipe endpoints and to discover pipe endpoints of services and applications.

In one embodiment, the rendezvous protocol may use an index cache (e.g. on a peer serving as a rendezvous proxy). FIG. 21 illustrates discovery through a rendezvous peer according to one embodiment. Rendezvous proxy 206 may cache peer 200 and peer group 210 information for peer groups 210A and 210B. Peers 200 in each peer group 210 may then discover each other through rendezvous proxy 206. Rendezvous proxy 206 may itself be a peer and may be a member in one or more peer groups 210. In one embodiment, access to rendezvous proxies 206 may be restricted to peers with rendezvous access privileges. In this embodiment, non-trusted peers (peers without access privileges) may access rendezvous proxies 206 through trusted peers 200 within their peer group 210, or alternatively through other local peers in other peer groups. In one embodiment, the rendezvous protocol may be used across subnets (configurable at the peer group level). In one embodiment, the rendezvous protocol may be used across/through firewalls (e.g. gateways).

In one embodiment, the peer-to-peer platform may include a propagate policy for use in discovery. FIG. 22 illustrates discovery through propagate proxies according to one embodiment. In one embodiment, discovery proxy 208 may control propagation of discovery messages. In FIG. 22, discovery proxy 208 may receive discovery messages from peers 200 in peer group 210A and propagate the messages to peers in other groups such as peer group 210B. In one embodiment, access to discovery proxies 208 may be restricted to peers with discovery proxy access privileges. In this embodiment, non-trusted peers (peers without access privileges) may access discovery proxies through trusted peers 200 within their peer group 210, or alternatively through other local peers in other peer groups: In one embodiment, propagation may be controlled using TTL (time to live). In another embodiment, propagation may be controlled using message counts. In one embodiment, the propagate policy may be used for subnet TCP/multicast (platform configurable). In one embodiment, the propagate policy may support HTTP gateways (platform configurable). In one embodiment, the propagate policy may be used through firewalls (e.g. need peer activation behind firewalls).

In one embodiment, the peer-to-peer platform may include an invite policy. In one embodiment, the invite policy may support the adding of new peers and peer groups (e.g. publish advertisements).

In one embodiment, the peer-to-peer platform may allow the persistent local peer caching of discovery information. In this embodiment, a peer may be allowed to cache advertisements discovered via the peer discovery protocol for later usage. Caching may not be required by the peer-to-peer platform, but caching may be a useful optimization. The caching of advertisements by a peer may help avoid performing a new discovery each time the peer is accessing a network resource. In a highly transient environment, performing the discovery may be necessary. In a static environment, caching may be more efficient.

In one embodiment, the peer-to-peer platform may support trusted discovery peers. In one embodiment, the peer-to-peer platform may use discovery credentials. In one embodiment, the peer-to-peer platform may allow credential delegation. In one embodiment, the peer-to-peer platform may support propagate proxies. In one embodiment, a propagate proxy may support TTL/message counts. TTL stands for Time To Live (how long the request lives in the system). In one embodiment, a propagate proxy may support net crawling. In one embodiment, a propagate proxy may provide “smart above” routing.

In one embodiment, a peer preferably does not initiate a new discovery request until the minimum allowable interval between discoveries is reached. This limitation on the maximum rate of discoveries may be similar to the mechanism required by Internet nodes to limit the rate at which ARP requests are sent for any single target IP address. The maximum rate may be defined by each specific implementation transport bindings and exported to the application.

FIG. 23 illustrates using messages to discover advertisements according to one embodiment. A message or messages may be used to get all known, reachable advertisements within a region on the network. This list is preferably not guaranteed to be exhaustive, and may be empty. Named peers may also be located using the peer discovery protocol. A message may include a peer group credential of the probing (requesting) peer that may identify the probing peer to the message recipient. The destination address may be any peer within a region (a propagate message 230) or alternatively a rendezvous peer (a unicast message 232). The response message 234 may return one or more advertisements (e.g. peer advertisements and/or peer group advertisements) that may include “main” endpoint addresses which may be converted to a string in the standard peer endpoint format (e.g. URI or URL) and also may include a network transport name. It is preferably not guaranteed that a response to a query request will be made. Preferably, the peer discovery protocol does not require a reliable transport. Multiple discovery query requests may be sent. None, one or multiple responses may be received.

In one embodiment, a discovery query message may be used to send a discovery request to find advertisements (e.g. for peers or peer groups). The discovery query may be sent as a query string (attribute, value) form. A null query string may be sent to match any results. A threshold value may be included to indicate the maximum number of matches requested by a peer. The following is an example of one embodiment of a discovery query message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <DiscoveryQuery>  <Credential> Credential </Credential>  <QueryId> query id</QueryId>  <Type> request type (e.g. PEER, GROUP, PIPE, SERVICE,  CONTENT)  </Type>  <Threshold> requested number of responses </Threshold>  <PeerAdv> peer advertisement of requestor </PeerAdv>  <Attr> attribute </Attr>  <Value> value </Value> </DiscoveryQuery>

Embodiments of a discovery query message may include, but are not limited to, the following fields:

-   -   Credential: The credential of the sender     -   QueryId: Query identifier     -   Type: specifies which advertisements are returned     -   Threshold: requested number of responses     -   PeerAdv: peer advertisement of requestor     -   Attr: specifies the query attribute     -   Value: specifies the query value

In one embodiment, the value tag is only present if the Attr tag field is present. Both the Attr and Value tag may be omitted.

In one embodiment, a discovery response message may be used to send a discovery response message to answer a discovery query message. The following is an example of one embodiment of a discovery response message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <DiscoveryResponse>  <Credential> Credential </Credential>  <QueryId> query id</QueryId>  <Type> request type (e.g. PEER, GROUP, PIPE, SERVICE,  CONTENT)  </Type>  <Attr> Attribute </Attr>  <Value> value </Value>  <Responses>    (peer, peer group, pipe, service or content advertisement    response)  </Responses>  <. . .>  <Responses>    (peer, peer group, pipe, service or content advertisement    response)  </Responses> </DiscoveryResponse>

Embodiments of a discovery response message may include, but are not limited to, the following fields:

-   -   Credential: The credential of the sender     -   QueryId: Query identifier     -   Type: specifies which advertisements are returned     -   Attr: specifies the query attribute     -   Value: specifies the query value     -   Responses: advertisement responses. The advertisement may be a         peer, peer group, pipe, content or service advertisement.

In one embodiment, the value tag is only present if the Attr tag field is present. Both the Attr and Value tag may be omitted.

In one embodiment, if an XML advertisement document is embedded into another XML document, the XML document separators must be dealt with. This may be done using the standard XML escaping rules. For example, ‘<’ becomes ‘&lt;’ ‘>’ becomes ‘&gt;’ and ‘&’ becomes ‘&amp’.

Reverse Discovery

Reverse discovery means that, in a peer-to-peer network, when a first entity (e.g. a peer) discovers a second entity (e.g. another peer), the second entity may also discover the first entity from the discovery initiated by the first entity. This may also be referred to as “mutual discovery”. In most traditional systems, discovery is typically one-directional. In the peer-to-peer world, reverse discovery is important because, by definition, all “peers” are equal (i.e. it is typically not a hierarchical system). In one embodiment, there may be different levels of discovery for peers. For example, a peer may be configured to remain anonymous when discovering other peers or to always support reverse discovery. In one embodiment, a peer initiating a discovery may also be configured to deny discovery to another peer if the other peer is configured or chooses to remain anonymous. In one embodiment, a peer may also be configured to or may choose to deny discovery by other peers that wish to remain anonymous.

Invitations

One embodiment of the discovery protocol may also provide methods by which a peer can “advertise” itself, for example when joining a peer-to-peer network. For example, a peer may send an email message, by telephone, by “traditional” mail, or by other methods to other peers it discovers or is preconfigured to know about to advertise its presence and willingness to be contacted by other peers. This is done outside of the discovery method, and may be performed by any external medium. A peer who receives an invitation from a peer may have a capability to add or enter the new peer to a list or database of peers that it knows about. When the peer later restarts, these peers may be among the preconfigured peers that the peer knows about. In one embodiment, a peer may have a “notify” or “invitation” interface to allow a user to initiate invitations. In one embodiment, the peer-to-peer platform may provide import and export capabilities for invitations. In one embodiment, the invitations may be implemented as documents external to the peer-to-peer system that may be exported from one peer and imported into another peer. In one embodiment, the invitations may be in a format that enables the exporting and importing. In one embodiment, the invitations may be in XML format. In one embodiment, an interface may be provided to allow the manual entering of invitation information. Importing the invitation may create a peer-to-peer platform document that may then be used by the peer. The format of exported documents may depend on the platform on which the peer is implemented.

Peer Resolver Protocol

In one embodiment, the peer-to-peer platform may include a peer resolver protocol that may allow a peer to send preferably simple, generic search queries to one or more peer services. In one embodiment, only those peers that have access to data repositories and that offer advanced search capabilities typically implement this protocol. Each service may register a handler in the peer group resolver service to process resolver query requests. Resolver queries may be demultiplexed to each service. Each service may respond to a peer via a resolver response message. It is important to point the differences between the peer discovery protocol and the peer resolver protocol. The peer discovery protocol is used to search for advertisements to bootstrap a peer, and discover new network resources. The peer resolver protocol is a generic service that services query protocols. The peer resolver protocol may be used by a service on a peer to interact with a service on another peer.

The peer resolver protocol may enable each peer to send and receive generic queries to find or search for peer, peer group, pipe or service specific information such as the state of a service or the state of a pipe endpoint. Preferably, each resolver query has a unique service handler name to specify the receiving service, and a query string to be resolved by the service. The peer resolver protocol preferably provides a generic mechanism for peers to send queries and receive responses. The peer resolver protocol preferably removes the burden for registered message handlers by each service and set message tags to ensure uniqueness of tags. The peer resolver protocol preferably ensures that messages are sent to correct addresses and peer groups. The peer resolver protocol preferably performs authentication and verification of credentials and the dropping of rogue messages. Preferably, there is no guarantee that a response to a resolver query request will be made. Preferably, a peer is not required to respond to a resolver query request. Preferably, a reliable transport is not required by the peer resolver protocol. In one embodiment, multiple resolver query messages may be sent. None, one or multiple responses may be received.

FIG. 24 illustrates one embodiment of using peer resolver protocol messages between a requesting peer 200A and a responding peer 200B. In one embodiment, a resolver query message 236 may be used to send (unicast) a resolver query request to a service on another member 200B of a peer group. In one embodiment, the resolver query may be sent as a query string to a specific service handler. Preferably, each query has a unique identifier. The query string may be any string that may be interpreted by the targeted service handler. A resolver response message 238 may be sent (unicast) to the requesting peer 200A by the service handler. The following is an example of one embodiment of a resolver query message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <ResolverQuery> <Credential> Credential </Credential> <HandlerName> name of handler </HandlerName> <QueryId> incremental query identifier </QueryId> <Query> query string </Query> </ResolverQuery>

Embodiments of a resolver query message may include, but are not limited to, the following fields:

-   -   Credential: The credential of the sender     -   QueryId: Query identifier     -   HandlerName: service the query needs to be passed     -   Query: query string

A resolver response message may be returned in response to a resolver query message. The following is an example of one embodiment of a resolver response message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <ResolverResponse> <Credential> Credential </Credential> <HandlerName> name of handler </HandlerName> <QueryId> query identifier </QueryId> <Response> response </Response> </ResolverResponse>

Embodiments of a resolver response message may include, but are not limited to, the following fields:

-   -   Credential: The credential of the sender     -   QueryId: Query identifier (long as a String)     -   HandlerName: service the query needs to be passed     -   Response: response String         Peer Information Protocol

Once a peer is located, its capabilities and status may be of interest. In one embodiment, the peer-to-peer platform may include a peer information protocol that may allow a peer to learn about other peers' capabilities and status. For example, a peer can send a ping message to see if another peer is alive. A peer may also query another peer's properties where each property has a name and a value string. Preferably, a peer is not required to respond to a peer information protocol request.

FIG. 25 illustrates one embodiment of using peer information protocol messages between a requesting peer 200A and a responding peer 200B. In one embodiment, to see if peer 200B is alive (i.e. responding to messages), peer 200A may be sent a ping message 240. The ping message 240 may include a destination address that is peer 200B's “main” endpoint returned during discovery, for example. The message may also include a group membership credential of the requesting peer 200A that may identify the probing peer 200A to the message recipient 200B. The message may also contain an identifier unique to the sender. This identifier is preferably returned in the response message 242. Response message 242 may include information about peer 200B, including information on the status of the peer 200B. If peer 200B responds with a message 242, this may indicate to peer 200A that peer 200B is “alive” and thus currently responding to messages.

In one embodiment, messages may be used to get a list of named control “properties” exported by a peer. A property is a “knob” used to get information or configuration parameters from the peer. All properties are preferably named (by a string), and are preferably “read-only”. In one embodiment, higher-level services may offer “read-write” capability to the same information, given proper security credentials. Each property preferably has a name and a value string. Read-write widgets may allow the string value to be changed, while read-only widgets do not. In one embodiment, the peer information protocol only gives read access. The destination address is a peer's main endpoint that may have been returned in a discovery response message.

Preferably, a reliable transport is not required by the peer information protocol. In one embodiment, multiple peer information messages may be sent. None, one or multiple responses may be received.

In one embodiment, a ping message may be sent to a peer to check if the peer is alive and/or to get information about the peer. The ping option may define the response type returned. In one embodiment, a full response (peer advertisement) or a simple acknowledge response (alive and uptime) may be returned. The following is an example of one embodiment of a ping message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <Ping> <Credential> Credential </Credential> <SourcePid> Source Peer identifier </SourcePid> <TargetPid> Target Peer identifier </TargetPid> <Option> type of ping requested</Option> </Ping>

In one embodiment, a peer information response message may be used to send a response message in response to a ping message. The following is an example of one embodiment of a peer information response message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <PeerInfo> <Credential> Credential </Credential> <SourcePid> Source Peer identifier </SourcePid> <TargetPid> Target Peer identifier </TargetPid> <Uptime> uptime</Uptime> <TimeStamp> timestamp </TimeStamp> <PeerAdv> Peer Advertisement </PeerAdv> </PeerInfo> Peer Membership Protocol

In one embodiment, the peer-to-peer platform may include a peer membership protocol that may allow a peer to join or leave peer groups, and to manage membership configurations, rights and responsibilities. This protocol may allow a peer to obtain group membership requirements (such as an understanding of the necessary credential for a successful application to join the group), to apply for membership and receive a membership credential along with a full group advertisement, to update an existing membership or application credential, and to cancel a membership or an application credential. In one embodiment, authenticators and/or security credentials may be used to provide the desired level of protection.

In one embodiment, the process of joining a peer group may include obtaining a credential that is used to become a group member. In one embodiment, the process of joining a peer group may include obtaining a “form” listing the set of requirements asked of all group members. In one embodiment, this form may be a structured document (e.g. a peer group advertisement) that lists the peer group membership service.

In one embodiment, the peer membership protocol may define messages including, but not limited to, an apply message, a join message, an acknowledgement (ACK) message, a renew message, and a cancel message. A peer membership protocol apply message may be sent by a potential new group member to the group membership application authenticator. The authenticator's endpoint is preferably listed in the peer group advertisement of every member. In one embodiment, a successful response from the group's authenticator may include an application credential and a group advertisement that preferably lists, at a minimum, the group's membership service. In one embodiment, the apply message may include, but is not limited to, the current credential of the candidate group member and the peer endpoint for the peer group membership authenticator to respond to with an acknowledgement (ACK) message.

The following is an example of one embodiment of a peer membership protocol apply message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <MembershipApply> <Credential> Credential of requestor </Credential> <SourcePid> Source pipe identifier </SourcePid> <Authenticator> Authenticator pipe advertisement </Authenticator> </MembershipApply>

A peer membership protocol join message may be sent by a peer to the peer group membership authenticator to join a group. The peer preferably passes an application credential (from an apply response ACK message) for authentication purposes. A successful response from the group's authenticator preferably includes a full membership credential and a full group advertisement that lists, at a minimum, the group's membership configurations requested of full members in good standing. The message may include a credential (application credential of the applying peer: see ACK message). This credential may be used as the application form when joining. The message may also include the peer endpoint for the authenticator to respond to with an ACK message.

The following is an example of one embodiment of a peer membership protocol join message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <MembershipJoin> <Credential> Credential of requestor </Credential> <SourcePid> Source pipe identifier </SourcePid> <Membersship> membership pipe advertisement </Membership> <Identity> identity</Identity> </MembershipJoin>

A peer membership protocol ACK message is an acknowledge message that may be used for both join and apply operations. A peer membership protocol ACK message may be sent back by the membership authenticator to indicate whether or nor the peer was granted application rights to the peer group if the peer is applying, or full membership to the peer group if peer is attempting to join. In one embodiment, an ACK message may also be sent in response to peer membership protocol renew messages and cancel messages. The message may include a credential (an application or membership credential allocated to the peer by the peer group authenticator). The message may also include a more complete peer group advertisement that may provide access to further configurations. In one embodiment, not all configuration protocols are visible until the peer has been granted membership or application rights. Some configurations may need to be protected. Also, depending on the peer credential, the peer may not have access to all the configurations.

The following is an example of one embodiment of a peer membership protocol ack message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <MembershipAck> <Credential> Credential </Credential> <SourcePid> Source pipe identifier </SourcePid> <Membersship> membership pipe advertisement </Membership> <Peer groupAdv> peer group advertisement </Peer groupAdv> <Peer groupCredential> credential granted </Peer groupCredential> </MembershipAck>

A peer membership protocol renew message may be sent by a peer to renew its credential (membership or application) access to the peer group. An ACK (acknowledgement) message may be returned with a new credential and lease if the new is accepted. The renew message may include, but is not limited to, a credential (a membership or application credential of the peer) and the peer endpoint to which an ACK response message may be sent.

The following is an example of one embodiment of a peer membership protocol renew message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <MembershipRenew> <Credential> Credential </Credential> <SourcePid> Source pipe identifier </SourcePid> <Membersship> membership pipe advertisement </Membership> </MembershipRenew>

A peer membership protocol cancel message may be sent by a peer to cancel the peer's membership or application rights in a peer group. The message may include, but is not limited to, a credential (a membership or application credential of the peer) and the peer endpoint to send an ACK message. In one embodiment, an ACK to a cancel may include a response status indicating the cancel was accepted.

The following is an example of one embodiment of a peer membership protocol cancel message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <MembershipCancel> <Credential> Credential </Credential> <SourcePid> Source pipe identifier </SourcePid> <Membersship> membership pipe advertisement </Membership> </MembershipCancel> Pipe Binding Protocol

In one embodiment, the peer-to-peer platform may include a pipe binding protocol that may allow a peer to find the physical location of a pipe endpoint and to bind a pipe advertisement to the pipe endpoint, thus indicating where messages actually go over the pipe. A pipe is conceptually a virtual channel between two pipe endpoints (input and output pipes) and may serve as a virtual link between two or more peer software components (e.g. services or applications).

A pipe may be viewed as an abstract, named message queue that supports a number of abstract operations such as create, open, close, delete, send, and receive. The pipe virtual link (pathway) may be layered upon any number of physical network transport links such as TCP/IP. Each end of the pipe may work to maintain the virtual link and to reestablish it, if necessary, by binding endpoints or finding the pipe's currently bound endpoints.

Actual pipe implementations may differ, but peer-to-peer platform-compliant implementations preferably use the pipe binding protocol to bind pipes to pipe endpoints. In one embodiment, during the abstract create operation, a local peer binds a pipe endpoint to a pipe transport. In another embodiment, bind may occur during the open operation. Unbind occurs during the close operation. In one embodiment, each peer that “opens” a group pipe may make an endpoint available (binds) to the pipe's transport. Messages are preferably only sent to one or more endpoints bound to the pipe. Peers that have not opened the pipe preferably do not receive or send any messages on that pipe. In one embodiment, when some peer software wants to accept incoming pipe messages, the receive operation may remove a single message in the order it was received, not in the order it was sent. In one embodiment, a peek operation may be used as a mechanism to see if any message(s) has arrived in the pipe's queue.

In one embodiment, the pipe binding protocol may define messages including, but not limited to, a query message and a response message. In one embodiment, a pipe binding protocol query message may be sent by a peer pipe endpoint to find a pipe endpoint bound to the same pipe advertisement. The following is an example of one embodiment of a pipe binding protocol query message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <PipeBindingQuery>  <Credential> query credential </Credential>  <Peer> optional tag. If present, it may include the peer identifier    of the only peer that should answer the request.  </Peer>  <Cached> true if the reply can come from a cache </Cached>  <PipeId> pipe identifier to be resolved </PipeId> </PipeBindingQuery>

In one embodiment, the requestor may ask that the information not be obtained from a cache. This is to obtain the most up-to-date information from a peer to address stale connection. The Peer field specifies a peer identifier. This peer is the one that should respond to the query. There is preferably no guarantee that a response to a pipe binding request will be made. Preferably, a peer is not required to respond to a binding request. Preferably, a reliable transport is not required. In one embodiment, multiple binding query messages may be sent. None, one or multiple responses may be received.

In one embodiment, a pipe binding protocol response message may be sent to the requesting peer by each peer bound to the pipe in response to a query message. The following is an example of one embodiment of a pipe binding protocol response message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <PipeBindingAnswer>  <Credential> credential </Credential>  <PipeId> pipe identifier resolved </PipeId>  <Peer> peer URI where a corresponding InputPipe has been  created  </Peer>  <Found> true: the InputPipe does exist on the specified peer (ACK)    false: the InputPipe does not exist on the specified peer    (NACK)  </Found> </PipeBindingAnswer> Endpoint Routing Protocol

In one embodiment, the peer-to-peer platform may include an endpoint routing protocol. The endpoint routing protocol may be used by peers to send messages to router peers requesting available routes for sending message(s) to destination peers.

A peer-to-peer platform network is typically an ad hoc, multi-hops, and adaptive network by nature. Connections in the network may be transient, and message routing may be nondeterministic. Routes may be unidirectional and change rapidly. Peers may appear and leave frequently. Two communicating peers may not be directly connected to each other. Two communicating peers may need to use router peers to route messages depending on the network topology. For example, the two peers may be on different network transports, or the peers may be separated by a firewall or a NAT (Network Address Translation) router. A peer behind a firewall may send a message directly to a peer outside a firewall. But a peer outside the firewall cannot establish a connection directly with a peer behind the firewall.

The endpoint routing protocol may define a set of request/query messages that is processed by a routing service to help a peer route messages to its destination. When a peer is asked to send a message to a given peer endpoint address, it may look in its local cache to determine if it has a cached route to this peer. If the peer does not find a route, it may send a route resolver query message to available peer routers requesting route information. A peer may have access to as many peer routers as it can find, or optionally a peer may be pre-configured to access certain routers.

Peer routers provide the low-level infrastructures to route a message between two peers in the network. Any number of peers in a peer group may elect themselves to become peer routers for other peers. Peers routers offer the ability to cache route information, as well as bridging different physical (different transport) or logical (firewall and NAT) networks. A peer may dynamically find a router peer via a qualified discovery search. A peer may find out if a peer it has discovered is a peer router via the peer advertisement properties tag.

When a peer router receives a route query, if it knows the destination (a route to the destination), it may answer the query by returning the route information as an enumeration of hops. The message may be sent to the first router and that router may use the route information to route the message to the destination peer. The route may be ordered from the next hop to the final destination peer. At any point the routing information may be obsoleted, requiring the current router to find a new route.

The peer endpoint may add extra routing information to the messages sent by a peer. When a message goes through a peer, the endpoint of that peer may leave its trace on the message. The trace may be used for loop detection and to discard recurrent messages. The trace may also be used to record new route information by peer routers.

In one embodiment, the endpoint routing protocol may provide the last resort routing for a peer. More intelligent routing may be implemented by more sophisticated routing services in place of the core routing service. High-level routing services may manage and optimize routes more efficiently than the core service. In one embodiment, the hooks necessary for user defined routing services to manipulate and update the route table information (route advertisements) used by the peer router may be provided by the endpoint routing protocol. Thus, preferably complex route analysis and discovery may be performed above the core by high-level routing services, and those routing services may provide intelligent hints to the peer router to route messages.

Router peers may cache route information. Router peers may respond to queries with available route information. Route information may include a list of gateways along the route. In one embodiment, any peer may become a router peer by implementing the endpoint routing protocol. The following is an example of one embodiment of route information in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <EndpointRouter> <Credential> credential </Credential> <Src>peer identifier of the source </Src> <Dest> peer identifier of the destination </Dest> <TTL> time to live </TTL> <Gateway> ordered sequence of gateway </Gateway> . . . <Gateway> ordered sequence of gateway </Gateway> </EndpointRouter>

The time-to-live parameter specifies how long this route is valid. The creator of the route can decide how long this route will be valid. The gateways may be defined as an ordered sequence of peer identifiers that define the route from the source peer to the destination peer. The sequence may not be complete, but preferably at least the first gateway is present. The first gateway is sufficient to initially route the messages. The remaining gateway sequence is preferably optional.

The endpoint routing protocol may provide messages including, but not limited to, a route request message and a route answer message from the router peer. In one embodiment, a peer may send a route request message to a router peer to request route information. Route information may be cached or not cached. In some cases, the route query request message may indicate to bypass the cache content and thus to search dynamically for a route. Preferably, it is not guaranteed that a route response will be received after a query is sent. The following is an example of one embodiment of a route query request message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <EndpointRouterQuery> <Credential> credential </Credential> <Dest> peer identifier of the destination </Dest> <Cached> true: if the reply can be a cached reply false: if the reply must not come from a cache </Cached> </EndpointRouterQuery>

In one embodiment, a router peer may send a route answer message to a peer in response to a route information request. The following is an example of one embodiment of a route answer message in XML, and is not intended to be limiting:

<?xml version=“1.0” encoding=“UTF-8”?> <EndpointRouterAnswer>  <Credential> credential </Credential>  <Dest> peer identifier of the destination </Dest>  <RoutingPeer> Peer identifier of the router that knows a route to  DestPeer  </RoutingPeer>  <RoutingPeerAdv> Advertisement of the routing peer  </RoutingPeerAdv>  <Gateway> ordered sequence of gateways </Gateway>  . . .  <Gateway> ordered sequence of gateways </Gateway> </EndpointRouterAnswer> Routing

A peer-to-peer platform preferably provides a mechanism or mechanisms for searching and accessing peers, peer groups, content, services and other information in a dynamic topology of peers and peer groups, where peers and peer groups can come and go. In one embodiment, peers and peer groups may come and go potentially with limited or no control and notification. Peers may connect to a peer-to-peer network through various wired and wireless protocols, including “not connected” protocols such as may be used by mobile consumer devices such as pagers and PDAs. Peers may also have to cross boundaries, for example boundaries created by firewalls and NAT (Network Address Translation) routers, to connect to other peers.

An application that supports the peer-to-peer platform preferably is able to help in routing and discovering. Some of the information needed to accomplish routing and discovering may be only known by the application. For example, the application may support a special type of data as content, and so the application may best “know” how to discover items of this special content. In addition, the application may have a better knowledge of the topology (related to the nature of the application and/or peer group) than the core peer-to-peer platform.

In one embodiment, in order to bootstrap the system, and in order to have a failback mechanism if an application cannot or does not support one or more of the tasks, the core peer-to-peer protocols may provide a discovery and router mechanism for discovering peers and other core abstractions such as advertisements, pipes, and peer groups. The discovery and routing mechanism of the peer-to-peer platform preferably uses as few protocols as possible, is simple, and makes use of underlying optimizations when available. Hooks into the core discovery and router mechanism may be provided so that applications and services may participate in the discovery and router mechanisms, for example, by passing information to the core discovery and router mechanism. In one embodiment, an application or service may be allowed to override the core discovery and router mechanism with its own custom mechanism.

In one embodiment, the core discovery and router mechanism may be based on web crawling. Web crawling may be well suited for use in self-organizing networks such as peer-to-peer networks. In one embodiment, peers may be configured to participate or not to participate in the discovery and router mechanism, and may be configured as to the level of involvement in the process In one embodiment, a peer may decide whether to participate in a discovery or routing task depending on the peer's configuration in the peer-to-peer network. In one embodiment, the configuration may be determined using an automated detection of the position of the peer on the network and a network configuration wizard tool.

Web crawling may not create bottlenecks such as may be created by the mechanism of a client knowing a server and always going to the same server to find and retrieve information (e.g. DNS, NFS etc.). Even if a server is replicated, like DNS, it is still a centralized server. If all the known instances of the server are not reachable, a client may lose access to the server, even if another (but unknown) server is, indeed, available. In a point-to-point network, the information a peer is looking for is generally “close by” or may eventually be “close by”, so web crawling may not go too far.

FIG. 26 illustrates several core components and how they interact for discovery and routing according to one embodiment. Application 300 may use discovery 308 to find peers, peer groups, advertisements, and other entities on the peer-to-peer network, and may also publish pipe, peer, peer group, service, and other advertisements for access by other peers, applications and services on the peer-to-peer network. In one embodiment, the endpoint 310 may be responsible for exchanging messages between peers that are directly “connected” to each other (i.e. the peers can reach each other without any routing and/or discovering). When available, multicast may be used to discover peers that the endpoint can reach (multicast is a mechanism which has been introduced in IP in order to optimize this kind of process). In addition to that, or when multicast is not available, A rendezvous and invitation mechanism may also be provided. The rendezvous and invitation method may be used, for example, if multicast is not available. For example, HTTP does not provide multicast capabilities.

The endpoint router 312 may manage a cache of routes, for example routes to remote peers. In one embodiment, the endpoint router 312 may be configured from caching no routes to caching all routes it is aware of, depending on what the configuration wizard has decided with user control. The endpoint router 312 may also forward (route) messages depending on what is found in the cache, and what has been configured. For instance, the endpoint router 312 may be configured to route search (propagate) requests or to not route the requests.

In one embodiment, the generic resolver 308 is a protocol that implements a sort of RPC (query/response) protocol on top of the endpoint 310. Discovery 306 and pipe resolver 304 may use the generic resolver. In one embodiment, discovery 306 may be responsible for searching, caching and generating core advertisements (e.g. peer, peer group, and pipe advertisements). Discovery 306 may use the generic resolver 308 to send query messages and to receive answers. In one embodiment, discovery 306 may be aware of rendezvous peers and may have an invitation mechanism that may be used to assist the generic resolver 308. In one embodiment, the pipe resolver 304 may be responsible for localizing the receiving end of a pipe 302 given a pipe advertisement. In one embodiment, the pipe resolver 304 does not search for a pipe advertisement. In one embodiment, the pipe resolver 304 may be configured to manage a cache of the locations of the receiving ends (i.e. receiving peers) of the pipe 302.

The pipe protocol may use the endpoint 310 for transferring messages (with the potential help of the endpoint router 312) between the sending end of the pipe 302, and the receiving end of the pipe 302. In one embodiment, a pipe 302 may be viewed as an endpoint 310 that has not been bound to a particular peer. In one embodiment, a pipe 302 may be moved seamlessly from one peer to another. In one embodiment, a pipe 302 may also provides uniqueness that may not be provided by an endpoint 310 since a pipe identifier is unique in time and space, and an endpoint 310, being a network address, may not be.

A discovery and router mechanism based on web crawling may be time-expensive, and higher level protocols (such as applications) may have information that the core is not aware of that may help in the web crawling process. In one embodiment, to enable applications to participate in the process, components of the core mechanism may provide hooks that enable the applications to assist in the process (e.g. by providing information). Some transport protocols such as HTTP may be configured for and/or dynamically learn about web rendezvous peers it can use. An application may be provided access to the list of rendezvous peers. In one embodiment, an application may be allowed to set/unset routes in an endpoint router 312. Each route may be qualified to route or not route propagate messages such as web crawling messages and/or unicast messages. The endpoint router 312 may be viewed as a route cache manager, which is may be controlled by an endpoint 310 and/or other entities that may need to control it. In one embodiment, an endpoint router 312 may be able to discover unknown routes from applications. In one embodiment, discovery 308 may be configured (statically and/or dynamically) to control the nature and the amount of data that it manages. In one embodiment, discovery 308 may be taught where to go search, or where not to go search. In one embodiment, discovery 308 may make an “upcall” to a search/retrieve mechanism. In one embodiment, a pipe resolver 304 may manage a cache of input pipes (receiving ends). In one embodiment, pipe resolver 304 may be accessed by applications to set/unset entries in the cache.

Router Peers

FIG. 27 illustrates one embodiment of message routing in a peer-to-peer network that uses the peer-to-peer platform. Peers 200 in peer groups 210A and 210B may communicate with each other through one or more router peers 244. In one embodiment, message routing may route messages to “unreachable” peers, i.e. may allow messages sent from a peer 200 to reach peers 200 that are otherwise unreachable. Networks may be partitioned by firewalls, NAT (Network Address Translation) routers, etc. Message routing may allow messages to be delivered in partitioned networks. Message routing may also allow peers 200 separated by one or more partitions to participate in the same peer group(s) 210. Message routing preferably provides optimized message delivery, for example by optimizing routes between peers 200. Message routing preferably allows for an adaptive peer-to-peer network (e.g. peers may move to remote locations and still receive messages). Message routing preferably provides load balancing. In one embodiment, any peer may be a router peer 244.

One embodiment may provide for HTTP routing servers. In one embodiment, HTTP routers may provide for message routes that traverse firewalls. In one embodiment, HTTP routers may provide NAT support. In one embodiment, HTTP routers may act as message gateways (TTL). TTL stands for Time To Live (how long the request lives in the system).

The widespread use of NAT (Network Address Translation) and firewalls may affect the operation of many P2P systems. It also may affect the peer-to-peer platform. In particular, a peer outside a firewall or a NAT gateway cannot discover peers inside the firewall or the NAT gateway. In the absence of getting system administrators to let the peer-to-peer platform traffic through (say by opening a special incoming port at the firewall or gateway), possible methods to deal with this problem include, but are not limited to:

-   -   In one embodiment, peers inside firewalls may be asked to         initiate connections to peers outside the firewall.     -   In one embodiment, peer nodes may be set up that operate like         mailbox offices where traffic to a peer inside the firewall is         queued up to be picked up at a designated relay peer outside the         firewall. The peer inside the firewall can initially reach         outside the firewall, select a relay peer, and widely advertise         this fact. Later, it can periodically contact the relay peer to         retrieve messages.

One embodiment of the peer-to-peer platform may provide router peers. The router peers may be at a lower level than rendezvous peers. The router peers may provide “pure” message routing. By looking at the destination and source addresses, the router peer may determine where a message needs to be sent. In one embodiment, a router peer may call or access a rendezvous peer to “discover” information about peers, etc. In other words, the router peer may access information from a rendezvous peer to use the information in routing messages.

In one embodiment, router peers may provide the lowest message routing layer in the peer-to-peer platform. Routing may involve complex topologies. For example, the routing peers may provide a method to route across a firewall, particularly from peers outside the firewall to peers inside the firewall. A peer cannot send a message directly to another peer behind a firewall, since by definition there may be no direct route from a peer outside the firewall to a peer inside the firewall. A router peer may route messages to a gateway peer (a mailbox server where messages for peers behind the firewall may be temporarily stored). In one embodiment, the gateway peer may be a router peer acting as a gateway. The peers behind the firewall may periodically poll the mailboxes provided by the gateway peer to determine if someone has tried to contact them (i.e. are there any messages in my mailbox?). Note that a “pipe” provides an abstraction at a higher level than the message routing provided by router peers, and thus, a pipe may be an abstraction across the network topology between peers, for example peers on opposite sides of a firewall, through which the peers may communicate. At the lowest level, one or more router peers may discover and establish the actual communications route between the peers. This level, however, may be transparent to the peers, who only “see” the pipes.

In one embodiment, a router peer may build a route table. The router peer may keep information about routes that it discovers and store them in the route table. This allows the router peer to build a knowledge base (the route table) about the network topology as more messages flow on the system. This information may be used by the router peer to discover and establish optimal routes between entities in the network, and may increase its ability to reach other peers.

A router peer may access another router peer it is aware of to get route information. The route information may be described as a stacked set of destinations (and the routes to the destinations). In one embodiment, the information the router peer stores on a particular route may be incomplete, because the router peer may only know about the route up to a certain point. For example, the router peer may know about a first portion of a route up to another router peer, which knows about the next portion of the route, and so on.

In one embodiment, each peer has a unique peer identifier that is independent of, and is not assigned to, fixed addresses. Peers may move around. Therefore, the peer-to-peer network topology may be dynamic, and may change every time a peer goes away or moves. Thus, the routing method provided by the router peers is preferably dynamic to support the dynamic topology. When a peer moves and reconnects, the peer is recognized as the same peer that was previously connected elsewhere in the network. This process may use the unique identifier of the peer to indicate that the peer is the same one that was previously connected elsewhere. In one example, when a peer moves, it may go through a discovery process to discover peers and rendezvous peers in its new local subnet or region. If the peer wishes to join a peer group that it used at its previous location, it may then attempt to discover other peers that have knowledge of the peer group or other peers in the peer group. The message may be passed through several router peers until it may reach a router peer that has knowledge about the peer group (e.g. a route to the peer group) to return to the requesting peer. For example, a user with a laptop may fly from a home office to another city. When the user connects to the network in the other city, a route may be established, through the services provided by router peers, to the home office network peer group. The user may then access email and other services provided by the peer group. From the user's standpoint, this process may seem automatic. For example, the user may not be required to “dial in” or connect remotely to an ISP to access the office as is required in typical networks using static addressing.

In one embodiment, when a peer becomes a router peer, it may access a stored route table as a starting point. In one embodiment, the peer may start from scratch with an empty route table. In one embodiment, the peer, when it becomes a router peer, may initiate a discovery of other router peers and/or rendezvous peers to get as much connectivity information to key peers in the network as possible.

In one embodiment, every peer may have knowledge of at least one router peer. In one embodiment, there may be a “universal router” that many or all peers may be aware of that may be accessed when a peer cannot find anyone. The universal router may be able to put the peer into contact with somebody (e.g. another peer) to help in the bootstrapping process.

Security

The security requirements of a P2P system are very similar to any other computer system. The three dominant requirements are confidentiality, integrity, and availability. These translate into specific functionality requirements that include authentication, access control, audit, encryption, secure communication, and non-repudiation. Such requirements are usually satisfied with a suitable security model or architecture, which is commonly expressed in terms of subjects, objects, and actions that subjects can perform on objects. For example, UNIX has a simple security model. Users are subjects. Files are objects. Whether a subject can read, write, or execute an object depends on whether the subject has permission as expressed by the permissions mode specified for the object. However, at lower levels within the system, the security model is expressed with integers, in terms of UID, GID, and the permission mode. Here, the low-level system mechanisms do not (need to) understand the concept of a user and do not (need to) be involved in how a user is authenticated and what UID and GID they are assigned.

In one embodiment, the peer-to-peer platform protocols may be compatible with widely accepted transport layer security mechanisms for message-based architectures such as Secure Sockets Layer (SSL) and Internet Protocol Security (IPSec). However, secure transport protocols such as SSL and IPSec only provide the integrity and confidentiality of message transfer between two communicating peers. In order to provide secure transfer in multi-hops network, a trust association may be established among all the intermediary peers. Security is compromised if anyone of the communication links is not secured.

The peer-to-peer platform security model may be implemented to provide a P2P web of trust. The web of trust may be used to exchange public keys among its members. Each peer group policy may permit some members to be trusted to the extent that they have the authority to sign public keys for other members as well as to do things like authenticate, add new members, and remove or revoke membership.

Embodiments may implement security classes for the RSA public key exchange, the RC4 byte stream cipher, and the SHA-1 hash algorithm, among others. These classes may enable privacy by the means of a P2P TLS implementation; integrity with signed hashes; non-repudiation using the web of trust; and MACs for data authenticity. Combinations of these classes may form security suites, and the peer-to-peer platform provides the mechanism to add new customized suites as required.

In some embodiments, for peer group authentication a separate Pluggable Authentication Module (PAM) may be provided. Embodiments may provide anonymous or guest login, and login with user name and password. A login session may be in clear or cipher-text as per the peer group security policy.

The security module may be available to the core level, and thus services, applications and advanced services and applications may plug in their own security components and protocols. For example, the web of trust may be defined by a policy that requires authorized peer group members to be well-known certificate authorities, and that peers exchange X509v3 CA signed certificates.

Given that the peer-to-peer platform is defined around the concepts of peers and peer groups, one embodiment may include a security architecture in which peer identifiers and group identifiers are treated as low-level subjects (just like UID and GID), codats are treated as objects (just like files), and actions are those operations on peers, peer groups, and codats.

The term “codat” as used herein refers to any computer content—code, data, applications, or other collection of computer representable resources. The peer-to-peer protocol preferably does not distinguish among different types of resources that can be stored on a computer and shared among peers in a peer group. Examples of “codat” include text files, photographs, applets, executable files, serialized Java objects, SOAP messages, etc. Codats are the elementary unit of information that is exchanged among peers. In this embodiment, given that codats may have arbitrary forms and properties, it may not be clear what sets of actions should be defined for them. In one embodiment, the codats may carry or include definitions of how they should be accessed. Such codats are analogous to objects, which define for themselves access methods others can invoke.

One or more of several other characteristics of the peer-to-peer platform may further affect the security requirements of the peer-to-peer platform. In one embodiment, the peer-to-peer platform may be focused on mechanisms and not policy. For example, UUIDs are used throughout, but they by themselves have no external meaning. Without additional naming and binding services, UUIDs are just numbers that do not correspond to anything like a user or a principal. Therefore, the peer-to-peer platform preferably does not define a high-level security model such as information flow, Bell-LaPadula, or Chinese Wall. In one embodiment, when UUIDs are bound to external names or entities to form security principals, authenticity of the binding may be ensured by placing in the data field security attributes, for example, digital signatures that testify to the trustworthiness of the binding. Once this binding is established, authentication of the principal, access control based on the principal as well as the prevailing security policy, and other functions such as resource usage accounting may be performed.

The peer-to-peer platform is preferably neutral to cryptographic schemes and security algorithms. As such, the peer-to-peer platform preferably does not mandate any specific security solution. In such cases, a framework may be provided where different security solutions can be plugged in. In one embodiment, hooks and placeholders may be provided so that different security solutions may be implemented. For example, every message may have a designated credential field that may be used to place security-related information. In one embodiment, exactly how to interpret such information is not defined in the peer-to-peer platform, and may be left to services and applications.

In one embodiment, the peer-to-peer platform may sometimes satisfy security requirements at different levels of the system. To allow maximum flexibility and avoid redundancy, the peer-to-peer platform preferably does not force a particular implementation on developers. Instead, preferably, enhanced platforms based on the peer-to-peer platform may provide the appropriate security solutions to their targeted deployment environment. To illustrate the last point, two security concerns (communications security and anonymity) are examined.

Peers communicate through pipes. As an example, suppose both confidentiality and integrity in the communications channel are desired. In one embodiment, Virtual Private Networks (VPNs) may be used to move all network traffic. In one embodiment, a secure version of the pipe may be created, similar to a protected tunnel, such that any message transmitted over this pipe is automatically secured. In one embodiment, regular communications mechanisms may be used, and specific data payloads may be protected with encryption techniques and digital signatures. Embodiments of the peer-to-peer platform may accommodate one or more of these and other possible solutions.

Anonymity does not mean the absence of identity. Indeed, sometimes a certain degree of identification is unavoidable. For example, a cell phone number or a SIM card identification number cannot be kept anonymous, because it is needed by the phone company to authorize and set up calls. As another example, the IP number of a computer cannot be hidden from its nearest gateway or router if the computer wants to send and receive network traffic. In general, anonymity can be built on top of identity, but not vice versa. There may be multiple ways to ensure anonymity. In the examples above, it is difficult to link a prepaid SIM card sold over the retail counter for cash to the actual cell phone user. Likewise, a cooperative gateway or router may help hide the computer's true IP address from the outside world by using message relays or NAT (Network Address Translation).

In one embodiment, a peer-to-peer platform-based naming service may bind a peer to a human user. The user's anonymity may be ensured through the naming service, or the authentication service, or a proxy service, or any combination of these. The peer-to-peer platform is preferably independent of the solution chosen by a particular application.

At many places, the peer-to-peer platform is preferably independent of specific security approaches. In one embodiment, the peer-to-peer platform may provide a comprehensive set of security primitives to support the security solutions used by various peer-to-peer platform services and applications. Embodiments of the peer-to-peer platform may provide one or more security primitives including, but not limited to:

-   -   A simple crypto library supporting hash functions (e.g., MD5),         symmetric encryption algorithms (e.g., RC4), and asymmetric         crypto algorithms (e.g., Diffie-Heilman and RSA).     -   An authentication framework that is modeled after PAM (Pluggable         Authentication Module, first defined for the UNIX platform and         later adopted by the Java security architecture).     -   A simple password-based login scheme that, like other         authentication modules, can be plugged into the PAM framework.     -   A simple access control mechanism based on peer groups, where a         member of a group is automatically granted access to all data         offered by another member for sharing, whereas non-members         cannot access such data.     -   A transport security mechanism that is modeled after SSL/TLS,         with the exception that it is impossible to perform a handshake,         a crypto strength negotiation, or a two-way authentication on a         single pipe, as a pipe is unidirectional.     -   The demonstration services called InstantP2P and CMS (content         management service) also make use of additional security         features provided by the underlying Java platform.

In one embodiment, peers, configurations, peer groups, and pipes form the backbone of the peer-to-peer platform. Security in some embodiments of the peer-to-peer platform may use credentials and authenticators (code (e.g. computer-executable instructions) that may be used to receive messages that either request a new credential or request that an existing credential be validated). A credential is a token that when presented in a message body is used to identify a sender and can be used to verify that sender's right to send the message to the specified endpoint and other associated capabilities of the sender. The credential is an opaque token that must be presented each time a message is sent. The sending address placed in the message envelope may be crosschecked with the sender's identity in the credential. In one embodiment, each credential's implementation may be specified as a plug-in configuration, which allows multiple authentication configurations to co-exist on the same network.

Preferably, all messages include, at a minimum, a peer group credential that identifies the sender of the message as a full member peer in the peer group in good standing. Membership credentials may be used that define a member's rights, privileges, and role within the peer group. Content access and sharing credentials may also be used that define a member's rights to the content stored within the group.

In one embodiment, the peer-to-peer platform may provide different levels of security. In one embodiment, APIs may be provided to access well known security mechanisms such as RCA. In one embodiment, the peer-to-peer platform may provide a distributed security mechanism in a peer-to-peer environment. In one embodiment, this distributed security may not depend on certificates administered by a central authority. The distributed security mechanism may allow a peer group “web of trust” to be generated. In the distributed security mechanism, peers may serve as certificate authorities (security peers). Each peer group may include one or more peers that may serve as a certificate authority in the group. In one embodiment, the creator of a peer group may become the default security authority in the group. In one embodiment, if there is more than one creator, the creator peers may choose one of the peers to be the security authority in the group. In one embodiment, the peer or peers that create a peer group may define the security methods that are to be used within the group (anywhere from no security to high levels of security). In one embodiment, more than one peer in a peer group may serve as a security peer. Since peers are not guaranteed to be up at all times, having multiple security peers in a peer group may help insure that at least one security peer is available at all times. In one embodiment, the peer group's certificate peer may verify keys to provide a weak level of trust. In one embodiment, peer-to-peer platform advertisements may include information to describe the security mechanism(s) to be used in a peer group. For example, the advertisement may include information to do public key exchange, information to indicate what algorithms are to be used, etc. The advertisement may also include information that may be used to enforce secure information exchange on pipes (e.g. encryption information).

In one embodiment, peer group security may establish a “social contract”. The role of security is distributed across peer groups, and across members of peer groups, that all agree to participate by the rules. A peer group may establish the set of rules by which security in the group is enforced. A peer may join the peer group with a low level of security clearance (low trust). If the peer stays in the group and behaves (follows the rules), the peer may build up its level of trust within the group, and may eventually be moved up in its security level. Within peer groups operating under a social contract, certificates and/or public keys may be exchanged without the participation of a strict certificate authority; i.e. the members may exchange certificates based upon their trust in each other. In one embodiment, a peer group may use an outside challenge (e.g. a secret group password) that may be encrypted/decrypted with public/private keys, as a method to protect and verify messages within the group. In one embodiment, peer groups may be configured to use other types of security, including a high level of security, for example using a strict certificate authority, and even no security. In one embodiment, peer-to-peer platform messages exchanged within a group may have a “placeholder” for security credentials. This placeholder may be used for different types of credentials, depending upon the security implementation of the particular group. In one embodiment, all peer-to-peer messages within the group may be required to have the embedded credential. One embodiment may support private secure pipes.

Peer-to-Peer Platform Firewalls and Security

The peer-to-peer platform may provide one or more methods for traversing firewalls. FIG. 28 illustrates traversing a firewall 248 in a virtual private network when access is initiated from outside only according to one embodiment. Peers 200 on either side of the firewall 248 may each belong to one or more peer groups. In one embodiment, entry may be restricted to peers 200 with access privileges. In this example, peers 200A and 200B have access privileges, but peer 200C does not. Thus, peers 200A and 200B may access peers 200D and 200E through firewall 248. In one embodiment, HTTP “tunnels” may be used, with proxies 246 in the “DMZ” of the firewall 248.

FIG. 29 illustrates email exchange through a firewall 248 via an email gateway 260 according to one embodiment. In this example, peers 200A and 200B outside the firewall 248 may exchange messages to peers 200C and 200D via the email gateway 260. In one embodiment, there may be an SMTP (Simple Mail Transfer Protocol) service 262 on each peer 200. In one embodiment, 100% peer-to-peer access may not be guaranteed. In one embodiment, inside the firewall 248, mail account administration may impose restrictions. In one embodiment, email addresses may not be required for all peers 200 outside of the firewall 248.

FIG. 30 illustrates several methods of traversing a firewall 248 when access is initiated from the inside according to one embodiment. One or more peers 200 may be inside the firewall 248, and one or more peers 200 may be outside the firewall 248. In one embodiment, each peer 200 that needs to traverse firewall 248 may include a mini-HTTP server. In this embodiment, an HTTP proxy may be used to provide peer-to-peer HTTP tunnels 264 through firewall 248. In one embodiment, Secure Shell (SSH) tunnels 266 may be used to traverse firewall 248. One embodiment may support SOCKS connections 268 if SOCKS is supported in the firewall 248. SOCKS is typically used to telnet/ftp to the “outside”. Other embodiments may include other methods of traversing firewalls.

In one embodiment, peer-to-peer platform core protocols may be used for firewall traversal. In one embodiment, the impact on the peer-to-peer protocol core may be minimized in the traversal method. In one embodiment, peers preferably use the “pure” core protocols for traversal whenever possible. In embodiments where the core protocols need to be extended for traversal, a “divide and conquer” technique is preferably used. In a divide and conquer technique, any new configurations (policies) are preferably isolated behind the firewall. A proxy or proxies may then be used to mediate with and bridge to the core protocols.

Preferably, peers on either side of the firewall may initiate peer group contact with full peer-to-peer protocol implementation including, but not limited to, the ability to initiate peer group discovery, the ability to join/leave peer groups, and the ability to create end-to-end pipes (cipher text data exchange when required).

FIG. 31 illustrates one embodiment of a peer-to-peer platform proxy service 270, and shows various aspects of the operation of the proxy service. One or more peers 200 may be inside a firewall 248, and one or more peers 200 may be outside the firewall 248. Peer-to-peer platform proxy service 270 is also shown outside the firewall 248. Proxy service 270 may be used to enable peer 200 and peer group contact across firewall 248. Firewall 248 may include an email gateway 260. In one embodiment, the proxy service 270 may be used to bridge peer-to-peer platform protocols 272 with HTTP 274, email 276 and/or SOCKS 278. The proxy service 270 may allow peers 200 to send requests to communicate across firewall 248. Through the proxy service 270, peer-to-peer platform messages may be posted for delivery across the firewall 248. In one embodiment, the proxy service 270 may allow secure pipes to be established across the firewall 248 as necessary.

FIG. 32 illustrates a method of using a proxy service for peer group registration according to one embodiment. The proxy service may permit firewall-independent peer group membership. Three peer regions 212 are shown, with two (region 212A and 212B) on one side of firewall 248 and one (region 212C) on the other side of firewall 248. A peer group 210 may be established that extends across the firewall 248 into regions 212A, 212B and 212C. One or more peers 200 in each region 212 may be members of the peer group 210.

FIG. 33 illustrates peer group registration across a firewall according to one embodiment. Peer region 212A is shown outside of a firewall 248 and peer region 212B is behind the firewall 248. Peer region 212A includes a peer-to-peer platform proxy service 270 and several peers 200. In one embodiment, a peer 200 may be serving as a proxy peer that provides the proxy service 270. Peer region 212B includes several peers 200 behind the firewall 248. At some point, peer 200D in peer region 212B may form a peer group 210. An advertisement for the peer group 210 may be registered on the proxy service 270 in the region 212A. One or more peers 200 in region 212A may be notified of the newly registered peer group 200 by the proxy service 270. In one embodiment, the proxy service may also notify other known peer-to-peer platform proxy services in this or other regions 212, who in turn may notify other proxy services, and so on. Peers 200 in region 212A may then apply for membership in peer group 200.

FIG. 34 illustrates a method of providing peer group membership through a peer-to-peer platform proxy service according to one embodiment. Peer regions 212A and 212B are shown outside of a firewall 248, and peer region 212C is behind the firewall 248. The two peer group regions 212 outside the firewall 248 each include a proxy service 270. At least one of the peers (peer 200F, in this example) in region 212C behind the firewall belongs to a peer group 210. The peer group 210 may be registered with the proxy services 270 in the regions 212A and 212B outside the firewall 248. A peer 200 in either of the regions outside the firewall may join the peer group 200 by proxy through the proxy service 270 in its region 212. Peers 200 in the regions 212 outside the firewall 248 that are members of the peer group 210 may also leave the peer group 210 through the proxy service 270. Membership information (e.g. included in peer group advertisements) for the peer group 200 may be synchronized on all known proxy services 270 outside the firewall 248. In one embodiment, a proxy, service 270 may be a member peer of all locally registered peer groups 200.

Several levels of authentication may be provided in one or more embodiments of the peer-to-peer platform. Anonymous login may be provided in one embodiment. In one embodiment, a plain text login (user or user and password) may be provided. In one embodiment, login with privacy may be provided. In this embodiment, public key exchange may be used and/or a symmetric master key. The login process preferably returns a credential to the joining peer so that the peer may bypass the login process until the credential expires. One embodiment may provide a public key chain that may be used by registered users to eliminate public key exchanges and thus provides unauthenticated access. On embodiment may provide secure public key exchange with signed certificates.

FIGS. 35A and 35B illustrate a method of providing privacy in the peer-to-peer platform according to one embodiment. FIG. 35A shows a peer region 212 with peers 200A and 200B and a peer-to-peer platform proxy service 270. Peers 200A and 200B may fetch and cache public keys from a public key chain 280 of the proxy service 270. The cached public keys preferably have expiration dates. Peers 200A and/or 200B may compute a master secret key for one or more of the public keys. Using the keys, cipher text may be exchanged between peers 200A and 200B in privacy as illustrated in FIG. 35B.

The peer-to-peer platform may include one or more methods for providing data integrity in the peer-to-peer environment. These methods may be used to insure that what is sent is what is received. One embodiment may use a standard hash on data (e.g. Secure Hash Algorithm (SHA-1) as defined by the Secure Hash Standard of the Federal Information Processing Standards Publication 180-1). A weak form and/or a strong form may be used in embodiments. In one embodiment, the weak form may use a public key ring and symmetric master to sign data. This method may work best between two peers each having he other's public key. In one embodiment, the strong form may use a symmetric key algorithm such as RSA (Rivest-Shamir-Adleman) and certificate authorities. In one embodiment, the peer-to-peer platform may provide a proxy public certificate authority service. The authority service may create, sign and distribute certificates (e.g. X509 certificates) for all peers on a public key chain. The proxy service's public key is preferably resident on each proxied peer. Other embodiments may utilize other integrity methods.

FIGS. 36A and 36B illustrate one embodiment of a method for using a peer-to-peer platform proxy service as a certificate authority. FIG. 36A illustrates a peer region 212 with several peers 200 and a proxy service 270. The proxy service 270 may distribute signed certificates in response to peer requests as required. The peers 200 may validate the proxy service 270 signature using a proxy service public key. As illustrated in FIG. 36B, when exchanging content with other peers 200, a peer 200 may sign the content with the destination peer's public key and distribute the cipher text.

Bootstrapping Mechanism

In the absence of an application, the peer-to-peer platform preferably provides a mechanism that may be used to discover basic core abstractions (e.g. peer, peer groups, advertisements, pipes). This basic mechanism is needed for bootstrapping a system, and so may be referred to as a bootstrapping mechanism. For example, if a user just downloaded a binary image that enables a device to become a peer in a peer-to-peer network that implements the peer-to-peer platform, the bootstrapping mechanism may be used to discover core abstractions since the “fresh” system may not have knowledge of or access to higher-level services.

The tasks of searching, discovering, and/or routing in a peer-to-peer network may be complicated. There are many different types of content, and there may not be a generic mechanism to best accomplish those tasks for all types of content. Therefore, letting an application or higher-level service perform these high-level search may be preferable, while providing simple, small, mechanisms for bootstrapping peer-to-peer platform-enabled applications.

The policies and/or protocols used by the core in order to achieve this bootstrapping are preferably as simple as possible and preferably may be implemented and used on a wide variety of platforms (e.g. PDAs, pagers, smart appliances, laptops, workstations, clusters of servers, etc.) and in a variety of network topologies. For example, some peers may not use TCP/IP, and some may not be connected to the Internet. The bootstrapping mechanism may be used as a fallback mechanism when nothing else is useable (e.g. in case of a failure of higher lever services). The bootstrapping mechanism is preferably highly configurable. In one embodiment, configuration “wizards” may be used for automatic configuration of the bootstrapping mechanism.

In one embodiment, other services (e.g. higher-level services and/or optional services) and applications may take over control of the bootstrapping mechanism. In one embodiment, the core protocols may provide an API or APIs to allow the service and/or application to dynamically teach and/or reconfigure the core policies. In one embodiment, a service or application may dynamically overload (i.e. replace) the core policies. For example, this may be done when the design of the application is so dependant on a specific algorithm that it cannot handle the default core policies.

Providing the bootstrapping mechanism in the peer-to-peer platform may help to allow the peer-to-peer platform to be used straight “out of the box”, and/or to be easily configured and installed, for use with a peer-to-peer platform-enabled application.

Peer Monitoring and Metering

Peer monitoring may include the capability to closely keep track of a (local or remote) peer's status, to control the behavior of a peer, and to respond to actions on the part of a peer. These capabilities may be useful, for example, when a peer network wants to offer premium services with a number of desirable properties such as reliability, scalability, and guaranteed response time. For example, a failure in the peer system is preferably detected as soon as possible so that corrective actions can be taken. It may be preferable to shut down an erratic peer and transfer its responsibilities to another peer.

Peer metering may include the capability to accurately account for a peer's activities, in particular its usage of valuable resources. Such a capability is essential if the network economy is to go beyond flat-rate services. Even for providers offering flat rate services, it is to their advantage to be able to collect data and analyze usage patterns in order to be convinced that a flat rate structure is sustainable and profitable.

In one embodiment, the peer-to-peer platform may provide monitoring and metering through the peer information protocol, where a peer can query another peer for data such as up time and amount of data handled. Security is important in peer monitoring and metering. In one embodiment, a peer may choose to authenticate any command it receives. In one embodiment, a peer may decide to not answer queries from suspect sources.

Peer-to-Peer Platform shell Application

One embodiment of the peer-to-peer platform may include a shell application as a development environment built on top of the platform. In one embodiment, the shell application may provide interactive access to the peer-to-peer platform via a simple command line interface. With the shell, shell scripts may be written. The shell may be executed in a networked environment. A user command in the shell may generate a sequence of message exchanges between a set of peers, with some computation occurring on remote peer nodes, and with the answer being returned to the user of the shell. Using the shell, peer-to-peer core building blocks such as peers, peer groups, pipes, and codats may be manipulated. Codats are units of contents that can hold both code and data. For example, a user, through the shell, can publish, search, and execute codats, discover peers or peer groups, create pipes to connect two peers, and send and receive messages.

In one embodiment, an interpreter in the shell may operate in a loop: it accepts a command, interprets the command, executes the command, and then waits for another command. The shell may display a prompt to notify users that it is ready to accept a new command.

In one embodiment with a Java-based implementation of the peer-to-peer platform, one or more of the shell commands may not be built in per se. The commands may be Java language programs and are dynamically loaded and started by the shell framework when the corresponding commands are typed in. Therefore, adding a new shell command may be performed by writing a program in the Java language.

In one embodiment, the shell may provide a “pipe” capability to redirect a command output pipe into another command input pipe. In one embodiment, shell commands may be given a standard input, output and error pipes that a user can connect, disconnect and reconnect to other shell commands. Commands can support other pipes if needed. In one embodiment of the shell, a user may dynamically disconnect and reconnect pipes between commands, as in the following example:

-   -   xxxx>cat>p1 myfile     -   xxxx>grep<p1 abcd     -   xxxx>grep<p1 efgh

In the above example, the first command “cat>p1 myfile” cats myfile into the output pipe p1. The second command then connects pipe p1 to grep's input pipe and searches for the string abcd. The third command then disconnects p1, redirects it to the new grep command's input pipe and searches for the string efgh.

In one embodiment, the peer-to-peer platform shell supports piping in both directions. A special operator such as “

” may used for creating crossing pipes between two commands. For example, with the following command “cmd1

cmd2”, the output pipe of the first command is connected to the standard input pipe of the second command, and at the same time the output pipe of the second command is connected to the standard input pipe of the first command. Of course, this operator has to be used carefully to avoid infinite data loops.

In one embodiment, applications other than peer-to-peer platform applications may be run from the shell. For content management, MIME type information included with a codat may be used to let local applications associated with well-known content types handle them automatically. The peer-to-peer platform may support the development of adaptors to allow the execution of external programs with appropriate security safeguards. An adapter may essentially map data and connect applications for remote launches. Some examples might be:

-   -   UNIX® stdio to peer-to-peer platform stdio adapter—such an         adaptor may enable piping of peer-to-peer platform commands to         UNIX® commands on UNIX® platforms.     -   Peer-to-peer platform stream to a media player adapter—such an         adaptor may be platform- and application-specific, but may         handle any necessary real-time data conversion between a         peer-to-peer platform pipe and the format required by the         player. These need not be unidirectional. For example, one might         adapt the output of a video capture application to become a         peer-to-peer platform stream.     -   HTML to peer-to-peer platform stdio—such an adaptor may be used         to post and get information to/from Web pages to allow         peer-to-peer platform peers to interact with existing Web sites.         For example, a peer-to-peer platform command can launch a search         for titles and prices on Amazon and pipe the results to other         peer-to-peer platform services.

CONCLUSION

Various embodiments may further include receiving, sending or storing instructions and/or data implemented in accordance with the foregoing description upon a carrier medium. Generally speaking, a carrier medium may include storage media or memory media such as magnetic or optical media, e.g., disk or CD-ROM, volatile or non-volatile media such as RAM (e.g. SDRAM, DDR SDRAM, RDRAM, SRAM, etc.), ROM, etc. As well as transmission media or signals such as electrical, electromagnetic, or digital signals, conveyed via a communication medium such as network and/or a wireless link.

The various methods as illustrated in the Figures and described herein represent exemplary embodiments of methods. The methods may be implemented in software, hardware, or a combination thereof. The order of method may be changed, and various elements may be added, reordered, combined, omitted, modified, etc.

Various modifications and changes may be made as would be obvious to a person skilled in the art having the benefit of this disclosure. It is intended that the invention embrace all such modifications and changes and, accordingly, the above description to be regarded in an illustrative rather than a restrictive sense. 

1. A peer-to-peer network system, comprising: a plurality of computers configured to implement a plurality of peer nodes coupled to a network; a class of software module provided by one or more of the peer nodes; a module class advertisement for the class of software module, wherein the module class advertisement defines a local behavior and an Application Programming Interface (API) for each of a plurality of peer-to-peer bindings that supports the class of software module, wherein the module class advertisement includes a module class identifier that uniquely identifies the class of software module, and wherein the module class advertisement further includes a role extension to the module class identifier for distinguishing two or more instances of the class of software module configured to perform different roles in a context; and a plurality of module specification identifiers that each uniquely identifies one of a plurality of module specifications of the class of software module, wherein each module specification includes an indication of an expected on-wire behavior and an indication of one or more network protocols for a particular embodiment of the class of software module.
 2. The peer-to-peer network system as recited in claim 1, further comprising a module specification advertisement for each module specification, wherein each module specification advertisement includes a corresponding module specification identifier.
 3. The peer-to-peer network system as recited in claim 2, wherein each module specification advertisement further includes one or more mechanisms to invoke and use the class of software module.
 4. The peer-to-peer network system as recited in claim 1, further comprising one or more module implementations for each module specification of the class of software module, wherein each module implementation is configured to execute within a particular execution environment.
 5. The peer-to-peer network system as recited in claim 4, wherein two or more module implementations of the class of software module configured to execute within a particular execution environment are configured to provide a common programming interface for execution within the particular execution environment.
 6. The peer-to-peer network system as recited in claim 1, wherein the class of software module is configured to express one or more dependencies via the module class identifier for an execution environment and module specification selected during configuration of the execution environment.
 7. The peer-to-peer network system as recited in claim 1, wherein the plurality of peer nodes are configured to participate in a peer-to-peer network environment in accordance with one or more peer-to-peer platform protocols for enabling the peer nodes to discover each other, communicate with each other, cooperate with each other to form peer groups, and to discover and access modules in the peer-to-peer network environment.
 8. A system, comprising: a processor; and a memory comprising program instructions, wherein the program instructions are executable by the processor to: generate a module class advertisement for a class of software module hosted by the system on a peer-to-peer network, wherein the module class advertisement defines a local behavior and an Application Programming Interface (API) for each of two or more peer-to-peer bindings that supports the class of software module; assign a module class identifier to the class of software module that uniquely identifies the class of software module; generate a role extension to the module class identifier for distinguishing two or more instances of the class of software module configured to perform different roles in a context; include the role extension to the module class identifier in the module class advertisement; and assign a different module specification identifier to each of a plurality of module specifications of the class of software module, wherein each module specification identifier uniquely identifies a corresponding module specification, and wherein each module specification indicates an expected on-wire behavior and one or more network protocols for a particular embodiment of the class of software module.
 9. The system as recited in claim 8, wherein the program instructions are further executable by the processor to include the module class identifier in the module class advertisement.
 10. The system as recited in claim 8, wherein the program instructions are further executable by the processor to generate a module specification advertisement for each module specification, wherein each module specification advertisement includes a corresponding module specification identifier.
 11. The system as recited in claim 10, wherein each module specification advertisement indicates one or more mechanisms to invoke and use the class of software module.
 12. The system as recited in claim 8, wherein the program instructions are further executable by the processor to generate one or more module implementations for each module specification of the class of software module, wherein each module implementation is configured to execute within a particular execution environment.
 13. The system as recited in claim 12, wherein the program instructions are further executable by the processor to provide a common programming interface for two or more module implementations of the class of software module configured to execute within a particular execution environment.
 14. The system as recited in claim 8, wherein the class of software module is configured to express one or more dependencies via the module class identifier for an execution environment and module specification selected during configuration of the execution environment.
 15. The system as recited in claim 8, wherein system is configured to participate as a peer node on the peer-to-peer network with one or more other peer nodes in a peer-to-peer network environment in accordance with one or more peer-to-peer platform protocols for enabling the peer nodes to discover each other, communicate with each other, cooperate with each other to form peer groups, and to discover and access modules in the peer-to-peer network environment.
 16. A method for describing and identifying abstract software modules, comprising: one or more of a plurality of peers in a peer-to-peer network environment hosting a class of software module; generating a module class advertisement for the class of software module, wherein the module class advertisement defines a local behavior and an Application Programming Interface (API) for each of a plurality of peer-to-peer bindings that supports the class of software module; assigning a module class identifier to the class of software module that uniquely identifies the class of software module; generating a role extension to the module class identifier for distinguishing two or more instances of the class of software module configured to perform different roles in a context; including the role extension to the module class identifier in the module class advertisement; and assigning a different module specification identifier to each of a plurality of module specifications of the class of software module, wherein each module specification identifier uniquely identifies a corresponding module specification, and wherein each module specification indicates an expected on-wire behavior and one or more network protocols for a particular embodiment of the class of software module.
 17. The method as recited in claim 16, further comprising including the module class identifier in the module class advertisement.
 18. The method as recited in claim 16, further comprising generating a module specification advertisement for each module specification, wherein each module specification advertisement includes a corresponding module specification identifier.
 19. The method as recited in claim 18, wherein each module specification advertisement further includes one or more mechanisms to invoke and use the class of software module.
 20. The method as recited in claim 16, further comprising generating one or more module implementations for each module specification of the class of software module, wherein each module implementation is configured to execute within a particular execution environment.
 21. The method as recited in claim 20, further comprising providing a common programming interface for two or more module implementations of the class of software module configured to execute within a particular execution environment.
 22. The method as recited in claim 16, wherein the class of software module is configured to express one or more dependencies via the module class identifier for an execution environment and module specification selected during configuration of the execution environment.
 23. The method as recited in claim 16, wherein the plurality of peers are configured to participate in the peer-to-peer network environment in accordance with one or more peer-to-peer platform protocols for enabling the peers to discover each other, communicate with each other, cooperate with each other to form peer groups, and to discover and access modules in the peer-to-peer network environment.
 24. A computer-accessible storage medium, comprising program instructions, wherein the program instructions are computer-executable to implement: generating a module class advertisement for a class of software module hosted by one or more of a plurality of peers in a peer-to-peer network environment, wherein the module class advertisement defines a local behavior and an Application Programming Interface (API) for each of a plurality of peer-to-peer bindings that supports the class of software module; assigning a module class identifier to the class of software module that uniquely identifies the class of software module; generating a role extension to the module class identifier for distinguishing two or more instances of the class of software module configured to perform different roles in a context; including the role extension to the module class identifier in the module class advertisement; and assigning a different module specification identifier to each of a plurality of module specifications of the class of software module, wherein each module specification identifier uniquely identifies a corresponding module specification, and wherein each module specification indicates an expected on-wire behavior and one or more network protocols for a particular embodiment of the class of software module.
 25. The computer-accessible storage medium as recited in claim 24, wherein the program instructions are further computer-executable to implement including the module class identifier in the module class advertisement.
 26. The computer-accessible storage medium as recited in claim 24, wherein the program instructions are further computer-executable to implement generating a module specification advertisement for each module specification, wherein each module specification advertisement includes a corresponding module specification identifier.
 27. The computer-accessible storage medium as recited in claim 26, wherein each module specification advertisement further includes one or more mechanisms to invoke and use the class of software module.
 28. The computer-accessible storage medium as recited in claim 24, wherein the program instructions are further computer-executable to implement generating one or more module implementations for each module specification of the class of software module, wherein each module implementation is configured to execute within a particular execution environment.
 29. The computer-accessible storage medium as recited in claim 28, wherein the program instructions are further computer-executable to implement providing a common programming interface for two or more module implementations of the class of software module configured to execute within a particular execution environment.
 30. The computer-accessible storage medium as recited in claim 24, wherein the class of software module is configured to express one or more dependencies via the module class identifier for an execution environment and module specification selected during configuration of the execution environment.
 31. The computer-accessible storage medium as recited in claim 24, wherein the plurality of peers are configured to participate in the peer-to-peer network environment in accordance with one or more peer-to-peer platform protocols for enabling the peers to discover each other, communicate with each other, cooperate with each other to form peer groups, and to discover and access modules in the peer-to-peer network environment.
 32. A peer-to-peer network system, comprising: a plurality of computers configured to implement a plurality of peer nodes coupled to a network; a class of software module provided by one or more of the peer nodes; a module class advertisement for the class of software module, wherein the module class advertisement defines a local behavior and an Application Programming Interface (API) for each of a plurality of peer-to-peer bindings that supports the class of software module, wherein the module class advertisement includes a module class identifier that uniquely identifies the class of software module, and wherein the module class advertisement further includes a role extension to the module class identifier for distinguishing two or more instances of the class of software module configured to perform different roles in a context; a plurality of module specification advertisements for the module class advertisement, wherein each module specification advertisement describes a different module specification including an expected on-wire behavior and a protocol of the class of software module; and one or more module implementation advertisements for each module specification advertisement, wherein each module implementation advertisement describes a particular module implementation of a corresponding module specification, wherein the module implementation is configured to execute within a particular execution environment.
 33. The peer-to-peer network system as recited in claim 32, wherein each module specification advertisement further describes one or more mechanisms to invoke and use the corresponding class of software module.
 34. The peer-to-peer network system as recited in claim 32, wherein each module specification advertisement includes a module specification identifier that uniquely identifies the module specification corresponding to the module specification advertisement.
 35. The peer-to-peer network system as recited in claim 32, wherein each module implementation advertisement includes a module specification identifier that uniquely identifies the module specification implemented by the module implementation advertisement.
 36. The peer-to-peer network system as recited in claim 32, wherein each module implementation advertisement includes information indicating a mechanism for accessing code of the particular module implementation.
 37. The peer-to-peer network system as recited in claim 32, wherein each module implementation advertisement is discoverable by peer nodes on the peer-to-peer network, and wherein the module implementation advertisements are configured for use by the peer nodes to implement corresponding module specifications in particular execution environments of the peer nodes.
 38. The peer-to-peer network system as recited in claim 32, wherein the plurality of peer nodes are configured to participate in a peer-to-peer network environment in accordance with one or more peer-to-peer platform protocols for enabling the peer nodes to discover each other, communicate with each other, cooperate with each other to form peer groups, and to discover and access modules in the peer-to-peer network environment.
 39. A system, comprising: a processor; and a memory comprising program instructions, wherein the program instructions are executable by the processor to: generate a module class advertisement for a class of software module hosted by the system, wherein the module class advertisement defines a local behavior and an Application Programming Interface (API) for each of a plurality of peer-to-peer bindings that supports the class of software module, wherein the module class advertisement includes a module class identifier that uniquely identifies the class of software module, and wherein the module class advertisement further includes a role extension to the module class identifier for distinguishing two or more instances of the class of software module configured to perform different roles in a context; generate a plurality of module specification advertisements for the module class advertisement, wherein each module specification advertisement describes a different module specification including an expected on-wire behavior and a protocol of the class of software module; and generate one or more module implementation advertisements for each module specification advertisement, wherein each module implementation advertisement describes a particular module implementation of a corresponding module specification, wherein the module implementation is configured to execute within a particular execution environment.
 40. The system as recited in claim 39, wherein each module specification advertisement further describes one or more mechanisms to invoke and use the corresponding class of software module.
 41. The system as recited in claim 39, wherein each module specification advertisement includes a module specification identifier that uniquely identifies the module specification corresponding to the module specification advertisement.
 42. The system as recited in claim 39, wherein each module implementation advertisement includes a module specification identifier that uniquely identifies the module specification implemented by the module implementation advertisement.
 43. The system as recited in claim 39, wherein each module implementation advertisement includes information indicating a mechanism for accessing code of the particular module implementation.
 44. The system as recited in claim 39, wherein each module implementation advertisement is discoverable by one or more peer nodes on the peer-to-peer network, and wherein the module implementation advertisements are configured for use by the peer nodes to implement corresponding module specifications in particular execution environments of the peer nodes.
 45. The system as recited in claim 39, wherein the system is a peer node configured to participate with other peer nodes in a peer-to-peer network environment in accordance with one or more peer-to-peer platform protocols for enabling the peer nodes to discover each other, communicate with each other, cooperate with each other to form peer groups, and to discover and access modules in the peer-to-peer network environment.
 46. A method for describing and identifying abstract software modules, comprising: one or more of a plurality of peers in a peer-to-peer network environment hosting a class of software module; generating a module class advertisement for the class of software module, wherein the module class advertisement defines a local behavior and an Application Programming Interface (API) for each of a plurality of peer-to-peer bindings that supports the class of software module; generating a module class identifier that uniquely identifies the class of software module; generating a module specification identifier that uniquely identifies the module specification; generating a role extension to the module class identifier for distinguishing two or more instances of the class of software module configured to perform different roles in a context; including the module class identifier and the role extension to the module class identifier in the module class advertisement; generating a plurality of module specification advertisements for the module class advertisement, wherein each module specification advertisement describes a different module specification including expected on-wire behavior and protocol of the class of software module; and generating a module implementation advertisement for each module specification advertisement, wherein the module implementation advertisement describes a module implementation of a respective module specification configured to execute within a particular execution environment.
 47. The method as recited in claim 46, wherein each module specification advertisement further describes one or more mechanisms to invoke and use the class of software module.
 48. The method as recited in claim 46, further comprising, for each module specification: including the module specification identifier in a corresponding module specification advertisement; and including the module specification identifier in the module implementation advertisement for the module specification advertisement.
 49. The method as recited in claim 46, wherein each module implementation advertisement is discoverable by peers on the peer-to-peer network, and wherein the module implementation advertisements are configured for use by the peers to implement corresponding module specifications in particular execution environments of the peers.
 50. The method as recited in claim 46, wherein the plurality of peers are configured to participate in the peer-to-peer network environment in accordance with one or more peer-to-peer platform protocols for enabling the peers to discover each other, communicate with each other, cooperate with each other to form peer groups, and to discover and access modules in the peer-to-peer network environment.
 51. A computer-accessible storage medium, comprising program instructions, wherein the program instructions are computer-executable to implement: one or more of a plurality of peers in a peer-to-peer network environment hosting a class of software module; generating a module class advertisement for the class of software module, wherein the module class advertisement defines the local behavior and Application Programming Interface (API) for each of two or more peer-to-peer bindings that supports the class of software module; generating a module class identifier that uniquely identifies the class of software module; generating a module specification identifier that uniquely identifies the module specification; generating a role extension to the module class identifier for distinguishing two or more instances of the class of software module configured to perform different roles in a context; including the module class identifier and the role extension to the module class identifier in the module class advertisement; generating a plurality of module specification advertisements for the module class advertisement, wherein each module specification advertisement describes a different module specification including expected on-wire behavior and protocol of the class of software module; and generating a module implementation advertisement for each module specification advertisement, wherein the module implementation advertisement describes a module implementation of a respective module specification configured to execute within a particular execution environment.
 52. The computer-accessible storage medium as recited in claim 51, wherein each module specification advertisement further describes one or more mechanisms to invoke and use the class of software module.
 53. The computer-accessible storage medium as recited in claim 51, wherein the program instructions are further computer-executable to implement, for each module specification: including the module specification identifier in a corresponding module specification advertisement; and including the module specification identifier in the module implementation advertisement for the module specification advertisement.
 54. The computer-accessible storage medium as recited in claim 51, wherein each module implementation advertisement is discoverable by peers on the peer-to-peer network, and wherein the module implementation advertisements are configured for use by the peers to implement corresponding module specifications in particular execution environments of the peers.
 55. The computer-accessible storage medium as recited in claim 51, wherein the plurality of peers are configured to participate in the peer-to-peer network environment in accordance with one or more peer-to-peer platform protocols for enabling the peers to discover each other, communicate with each other, cooperate with each other to form peer groups, and to discover and access modules in the peer-to-peer network environment. 